codemcp: assistente de codificação MCP para o Claude Desktop

Introdução geral

O codemcp é uma ferramenta de código aberto projetada para Claude Design de usuário do desktop, desenvolvido por Edward Z. Yang no GitHub. Ele torna o Claude Desktop um assistente útil de programação em pares. Os usuários podem solicitar ao Claude que implemente recursos, corrija bugs ou refatore sua base de código local diretamente por meio do diálogo, sem precisar copiar e colar manualmente o código. suporte a codemcp Antrópica O serviço de assinatura Claude Pro (US$ 20 por mês) evita altas taxas de API. Ele garante operações de IA seguras e controladas, limitando o conjunto de ferramentas e impondo o uso do controle de versão do Git. Os desenvolvedores podem verificar e ajustar o código com seus IDEs favoritos para uma variedade de cenários de programação.

Lista de funções

• Edição direta do código localModificação de arquivos de projeto via Claude para salvar automaticamente as alterações.
• Execução de testes e formataçãoExecutar scripts de teste e comandos de formatação para manter a qualidade do código.
• Gerenciamento de Commit do GitGeração de commits do Git para cada alteração, com suporte para visualização e reversão.
• Suporte à configuração de projetosInicialização do projeto com um arquivo de configuração para carregar comandos personalizados.
• Rastreamento de registrosRegistre os detalhes da operação para facilitar a solução de problemas.

Usando a Ajuda

Processo de instalação

Para usar o codemcp, primeiro você precisa instalar as dependências e configurar o ambiente. Veja a seguir as etapas detalhadas:

1. Instalando a ferramenta uv
   O codemcp depende do uv para ser executado. Primeiro instale o uv, recomendamos usar o script de instalação oficial:
   • Linux/MacOS:

     curl -LsSf https://astral.sh/uv/install.sh | sh
     

   • Windows (PowerShell):

     powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
     

   Após a instalação, execute uv --versão Verifique a versão para ter certeza de que a instalação foi bem-sucedida.

2. Configuração do Claude Desktop
   Abrir ou criar claude_desktop_config.json adicione o seguinte:

{
"mcpServers": {
"codemcp": {
"comando": "uvx",
"args": [
"--from".
"git+https://github.com/ezyang/codemcp@prod",
"codemcp"
]
}
}
}

Depois de salvar, o Claude Desktop carregará o codemcp do GitHub via uvx.

3. Configuração do perfil do projeto
   Na raiz do seu repositório Git, crie o arquivo codemcp.toml Documentação. Exemplo:

format = [". /run_format.sh"]
test = [". /run_test.sh"]

• formatoCaminho do script de formatação: Especifica o caminho do script de formatação para a normalização do código.
• testeEspecifique o caminho do script de teste para executar o teste.
  Esses scripts precisam ser escritos por você mesmo para garantir que o ambiente virtual possa ser ativado e executado corretamente.

Como usar

Após a conclusão da instalação, você poderá operar o codemcp no Claude Desktop:

1. projeto de inicialização

Crie um novo projeto no Claude Desktop e insira-o nas Instruções do projeto:

Antes de fazer qualquer coisa, primeiro inicie o projeto $PROJECT_DIR.

comandante-em-chefe (militar) $PROJECT_DIR Substitua-o pelo caminho de seu projeto, por exemplo /Usuários/nome de usuário/myproject. Após a inicialização, o codemcp lerá o codemcp.toml Configuração.

2. mudança de códigos por meio de diálogo

Na janela de bate-papo do Claude Desktop, diga diretamente ao Claude o que você deseja alterar. Exemplo:

• "Adicione uma função ao main.py que calcula a série de Fibonacci."
• "Corrigir erro lógico no utils.py."
  O Claude editará o arquivo por meio do codemcp e gerará automaticamente um commit do Git após cada alteração. Isso pode ser feito com Registro git Visualizar o histórico de envios.

3. verificação e gerenciamento de alterações no código

Recomenda-se que uma ramificação separada (por exemplo desenvolver) para executar o codemcp com o ramo padrão definido como principalVeja a seguir os comandos comuns do Git. Veja a seguir os comandos comuns do Git:

• Exibir alterações::git diff main Exibe a diferença em relação à ramificação principal.
• Aceitação de mudanças::git fetch . develop:main Mesclar alterações na ramificação principal.
  • Retenção do histórico de envios: primeiro git checkout mainmais uma vez git merge develop --no-ff.
  • Submissão de compressão: Executar git rebase -iSe você não tiver certeza do que deseja fazer, selecione squash e, em seguida, execute fetch.
• Retirada de alterações::git reset --keep main Restaurar o estado da ramificação principal.

4. teste de implementação e formatação

Se você configurar o teste responder cantando formatoVocê pode pedir ao Claude para executar esses comandos. Por exemplo:

• "Execute todos os testes e verifique se o código funciona."
• "Formatação do código após a conclusão da missão".
  Os testes são executados na metade da tarefa e a formatação é realizada no final da tarefa.

5. manuseio da limitação de fluxo

O Claude Pro tem um limite de tempo, e o Claude faz uma pausa quando encontra um limite de fluxo. Você pode usar esse tempo:

• Verifique o código gerado.
• Planejar as próximas tarefas.
  Quando a restrição for suspensa, basta continuar o diálogo.

6. visualização do livro de registro

Se você tiver problemas, consulte o ~/.codemcp/codemcp.log Arquivo de registro. Para obter um registro mais detalhado, edite o arquivo ~/.codemcprc::

[registrador]
verbosidade = "DEBUG"

Os níveis suportados são DEBUG, INFO, WARNING, ERROR e CRITICAL.

Operação da função em destaque

• projeto de segurançaO codemcp limita o escopo das ferramentas do Claude para evitar o uso indevido. Todas as alterações são revertidas via Git.
• Compatível com IDEAlterações no código podem ser revisadas e ajustadas com qualquer IDE (por exemplo, VS Code).
• controle manualAgentes não automatizados: cada tarefa precisa ser verificada e continuada pelo usuário para garantir que o código esteja indo na direção certa.

Com essas etapas, você pode começar a usar o codemcp rapidamente e melhorar sua eficiência de programação.