Safe File MCP

Abre una terminal en la carpeta de tu proyecto actual y ejecuta:

npx context-coder

Para edición parcial basada en líneas en lugar de reescrituras completas de archivos, usa:

npx context-coder --edit-file-mode

Luego agrega esto a la configuración de Claude Desktop y reinicia Claude Desktop después:

{
  "mcpServers": {
    "context-coder": {
      "command": "npx",
      "args": ["-y", "supergateway", "--streamableHttp", "http://localhost:3001/mcp"]
    }
  }
}

A continuación, crea un Proyecto de Claude e inserta el prompt inicial recomendado justo debajo de esta sección.

Ejecutar a través de Docker proporciona un mejor aislamiento ya que el contenedor no podrá escribir cosas fuera del directorio de tu proyecto.

Crea un archivo docker-compose.yml en el/los proyecto(s) en los que quieras trabajar.

services:
  context-coder:
    image: ghcr.io/khromov/context-coder:full
    ports:
      - '3001:3001'
    volumes:
      - ./:/app
    working_dir: /app

Para la variante de edición (ediciones parciales basadas en líneas):

services:
  context-coder:
    image: ghcr.io/khromov/context-coder:edit
    ports:
      - '3001:3001'
    volumes:
      - ./:/app
    working_dir: /app

Inicia el servicio:

docker-compose up

Luego agrega esto a la configuración de Claude Desktop y reinicia Claude Desktop después:

{
  "mcpServers": {
    "context-coder": {
      "command": "npx",
      "args": ["-y", "supergateway", "--streamableHttp", "http://localhost:3001/mcp"]
    }
  }
}

Dado que docker-compose up ya sabe en qué carpeta se está ejecutando, podemos cambiar fácilmente entre proyectos lanzando docker-compose up en diferentes directorios. ¡No olvides cambiar entre Proyectos de Claude cuando hagas esto!

A continuación, crea un Proyecto de Claude e inserta el prompt inicial recomendado justo debajo de esta sección.

Use the Context Coder MCP to edit files. Remember that partial edits are not allowed, always write out the edited files in full through the MCP. You MUST call the get_codebase_size and get_codebase MCP tools at the start of every new chat. Do not call read_file, as you already have the codebase via get_codebase - use this reference instead. ONLY call read_file if you can't find the file in your context. Do not create any artifacts unless the user asks for it, just call the write_file tool directly with the updated code. If you get cut off when writing code and the user asks you to continue, continue from the last successfully written file to not omit anything.

Si estás usando --edit-file-mode, usa este prompt en su lugar:

Use the Context Coder MCP to edit files. You have access to both edit_file (for line-based partial edits) and write_file (for complete file rewrites) tools. Use edit_file when making small, targeted changes and write_file when rewriting entire files or making extensive changes. Always use write_file if writing with edit_file fails. You MUST call the get_codebase_size and get_codebase MCP tools at the start of every new chat. Do not call read_file, as you already have the codebase via get_codebase - use this reference instead. ONLY call read_file if you can't find the file in your context. Do not create any artifacts unless the user asks for it, just call the MCP tools directly with the updated code. If you get cut off when writing code and the user asks you to continue, continue from the last successfully written file to not omit anything.

Opción 1: npx

Crea .mcp.json en la raíz de tu proyecto:

{
  "mcpServers": {
    "context-coder": {
      "command": "npx",
      "args": ["-y", "context-coder", "--mini", "--stdio"]
    }
  }
}

Para edición parcial basada en líneas en lugar de reescrituras completas de archivos, usa:

{
  "mcpServers": {
    "context-coder": {
      "command": "npx",
      "args": ["-y", "context-coder", "--mini", "--stdio", "--edit-file-mode"]
    }
  }
}

¡Listo!

Opción 2: Docker

Ejecutar a través de Docker proporciona un mejor aislamiento ya que el contenedor no podrá escribir cosas fuera del directorio de tu proyecto.

Crea .mcp.json en la raíz de tu proyecto:

{
  "mcpServers": {
    "context-coder": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-v",
        "./:/app",
        "-w",
        "/app",
        "-e",
        "COCO_MCP_TRANSPORT=stdio",
        "ghcr.io/khromov/context-coder:mini"
      ]
    }
  }
}

Opción 3: Vía HTTP + mcp-remote

Para Claude Code, crea .mcp.json en la raíz de tu proyecto:

{
  "mcpServers": {
    "context-coder": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "supergateway", "--streamableHttp", "http://localhost:3001/mcp"]
    }
  }
}

Y crea docker-compose.yml en tu proyecto:

services:
  context-coder:
    image: ghcr.io/khromov/context-coder:mini
    ports:
      - '3001:3001'
    volumes:
      - ./:/app
    working_dir: /app
    environment:
      - COCO_MCP_TRANSPORT=http
    restart: unless-stopped

Inicia Context Coder con docker-compose up y Claude Code se conectará automáticamente.

La razón para usar la compilación mini es que Claude Code ya viene con herramientas de edición de archivos integradas.

Prompt inicial recomendado: Agrega esto al inicio de tu archivo CLAUDE.md.

You have access to both Claude Code's built-in file tools and the Context Coder MCP for enhanced codebase analysis. Follow this workflow:

1. ALWAYS start every new chat by calling get_codebase_size and get_codebase MCP tools to ingest and understand the full project context
2. Use Context Coders's codebase analysis as your primary reference - avoid reading files since you already have the complete codebase, only read file if you are missing something or if the user specifically requests it.
3. Remember: Context Coder gives you full codebase context, Claude Code gives you precise editing control - use both strategically

Montajes de Volúmenes

Monta un directorio específico:

volumes:
  - ./src:/app # Only expose src directory

Variables de Entorno

• COCO_DEV: "true" o "false" para montar la carpeta ./mount en lugar de usar /app
• COCO_MCP_TRANSPORT: Establece a stdio o http (predeterminado: http)
• COCO_PORT: Sobrescribe el puerto predeterminado 3001 (solo modo HTTP)
• CONTEXT_CODER_EDIT_MODE: Establece a "true" para habilitar la herramienta edit_file (equivalente a la bandera --edit-file-mode)

Clona e instala las dependencias:

npm install

Compila y ejecuta:

npm run build
npm start  # HTTP mode
npm start -- --stdio  # stdio mode

Modo de desarrollo con recarga automática:

npm run dev

En modo de desarrollo, las operaciones de archivos están aisladas en el directorio ./mount.

Compila todas las versiones:

./build-all.sh

O compila individualmente:

# Full version
docker build -t context-coder:latest .

# Mini version
docker build --build-arg COCO_BUILD_TYPE=mini -t context-coder:mini .

# Edit version
docker build --build-arg COCO_BUILD_TYPE=edit -t context-coder:edit .

Construye una imagen personalizada:

FROM ghcr.io/khromov/context-coder:full
# Add customizations

O compila desde el código fuente:

docker build -t my-coco .