Repomix

Servidor MCP de Repomix

Un servidor de Model Context Protocol (MCP) que proporciona acceso a la herramienta repomix para empaquetar repositorios en archivos compatibles con IA.

Seguridad

• Rutas de entrada: El servidor restringe el acceso a archivos al directorio desde el que se inició. Cualquier intento de acceder a archivos fuera de este directorio (como /etc/) será denegado.
• Archivos de salida: Toda la salida se escribe en el directorio temporal del sistema y se limpia automáticamente después de que se devuelvan los contenidos.
• URLs remotas: Las URLs de repositorios remotos todavía están permitidas para su procesamiento.

Instalación

npm install
npm run build

Uso

Claude Code

claude mcp add --scope user repomix node /path/to/repomix-mcp/dist/index.js

Claude Desktop

Añade este servidor a la configuración de tu cliente MCP en tu claude_desktop_config.json:

{
  "mcpServers": {
    "repomix": {
      "command": "node",
      "args": ["/path/to/repomix-mcp/dist/index.js"]
    }
  }
}

Herramientas Disponibles

Ambas herramientas aceptan los mismos parámetros:

Parámetros

Parámetro	Tipo	Obligatorio	Descripción	Ejemplos
path	string	No	Ruta del directorio a empaquetar	/path/to/repo
style	enum	No	Estilo de formato de salida	xml, markdown, plain
compress	boolean	No	Comprimir la salida para reducir el número de tokens	true, false
include	string	No	Archivos a incluir (patrón glob)	*.md,*.ts,*.js, *.py, src/**/*.go
ignore	string	No	Archivos a excluir (patrón glob)	*test*,*spec*,dist/**,build/**
remote	string	No	URL de repositorio remoto a procesar	https://github.com/user/repo

repomix-estimate

Estima el tamaño de la salida de repomix sin recuperar el contenido. Úsalo primero para comprobar si la salida cabrá en tu ventana de contexto.

Devuelve:

• Tamaño del archivo en KB/MB
• Número estimado de tokens (~4 caracteres por token)
• Si la compresión está habilitada

Salida de repomix-estimate

Repomix output size estimate:
- Size: 5.27 KB (0.01 MB)
- Estimated tokens: ~1,349
- Compression: disabled

Use the repomix tool with these same parameters to retrieve the actual content.

repomix

Empaqueta un repositorio en un único archivo compatible con IA. Devuelve el contenido del archivo generado.

Mejor práctica: Usa siempre repomix-estimate primero para comprobar el tamaño de la salida, luego usa repomix con los parámetros adecuados (especialmente compress=true para repositorios grandes).

Ejemplo de uso en Claude:

1. Primero comprueba el tamaño: use repomix-estimate tool
2. Si el tamaño es razonable: use repomix tool
3. Si es demasiado grande, prueba con compresión: use repomix-estimate tool with compress=true
4. Luego recupera: use repomix tool with compress=true

Flujo de trabajo: Estima siempre primero, y recupera solo si el tamaño se ajusta a tus necesidades.

Salida de repomix (primeras 15 líneas)

This file is a merged representation of a subset of the codebase, containing specifically included files, combined into a single document by Repomix.

<file_summary>
This section contains a summary of this file.

<purpose>
This file contains a packed representation of the entire repository's contents.
It is designed to be easily consumable by AI systems for analysis, code review,
or other automated processes.
</purpose>

<file_format>
The content is organized as follows:
1. This summary section
2. Repository information