Safe File MCP

Abra um terminal na pasta do seu projeto atual e execute:

npx context-coder

Para edição parcial baseada em linhas em vez de reescrita completa de arquivos, use:

npx context-coder --edit-file-mode

Em seguida, adicione isto à configuração do Claude Desktop e reinicie o Claude Desktop depois:

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

A seguir, crie um Projeto Claude e insira o prompt inicial recomendado logo abaixo desta seção.

Executar via Docker proporciona melhor isolamento, pois o contêiner não conseguirá gravar nada fora do diretório do seu projeto.

Crie um arquivo docker-compose.yml no(s) projeto(s) em que deseja trabalhar.

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

Para a variante de edição (edições parciais baseadas em linhas):

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

Inicie o serviço:

docker-compose up

Em seguida, adicione isto à configuração do Claude Desktop e reinicie o Claude Desktop depois:

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

Como o docker-compose up já sabe em qual pasta está sendo executado, podemos alternar facilmente entre projetos iniciando o docker-compose up em diretórios diferentes. Não se esqueça de alternar entre os Projetos Claude ao fazer isso!

A seguir, crie um Projeto Claude e insira o prompt inicial recomendado logo abaixo desta seção.

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.

Se você estiver usando o --edit-file-mode, use este prompt:

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.

Opção 1: npx

Crie o arquivo .mcp.json na raiz do seu projeto:

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

Para edição parcial baseada em linhas em vez de reescrita completa de arquivos, use:

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

Pronto!

Opção 2: Docker

Executar via Docker proporciona melhor isolamento, pois o contêiner não conseguirá gravar nada fora do diretório do seu projeto.

Crie o arquivo .mcp.json na raiz do seu projeto:

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

Opção 3: Via HTTP + mcp-remote

Para Claude Code, crie o arquivo .mcp.json na raiz do seu projeto:

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

E crie o arquivo docker-compose.yml no seu projeto:

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

Inicie o Context Coder com docker-compose up e o Claude Code se conectará automaticamente.

A razão para usar a versão mini é que o Claude Code já vem com ferramentas de edição de arquivos integradas.

Prompt inicial recomendado: Adicione isto no início do seu arquivo 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

Montagens de Volume

Monte um diretório específico:

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

Variáveis de Ambiente

• COCO_DEV: "true" ou "false" para montar a pasta ./mount em vez de usar /app
• COCO_MCP_TRANSPORT: Defina como stdio ou http (padrão: http)
• COCO_PORT: Substitui a porta padrão 3001 (somente modo HTTP)
• CONTEXT_CODER_EDIT_MODE: Defina como "true" para habilitar a ferramenta edit_file (equivalente ao sinalizador --edit-file-mode)

Clone e instale as dependências:

npm install

Compile e execute:

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

Modo de desenvolvimento com recarga automática:

npm run dev

No modo de desenvolvimento, as operações de arquivo são isoladas no diretório ./mount.

Compile todas as versões:

./build-all.sh

Ou compile 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 .

Crie uma imagem personalizada:

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

Ou compile a partir do código-fonte:

docker build -t my-coco .