Make

Execute alvos make de qualquer Makefile em um ambiente seguro e controlado.

Documentação

MCP Server Make

Um servidor Model Context Protocol que fornece funcionalidade make. Este servidor permite que LLMs executem alvos make de qualquer Makefile de forma segura e controlada.

Visão Geral

O servidor expõe a funcionalidade make através do Model Context Protocol, permitindo que LLMs como Claude possam:

Executar alvos make com segurança e captura de saída
Entender e navegar por processos de build
Ajudar com tarefas de desenvolvimento
Lidar com erros de forma adequada
Respeitar o contexto do diretório de trabalho

O MCP Server Make funciona com qualquer Makefile válido - você pode usar o Makefile opinativo incluído ou seus próprios scripts de build personalizados.

Início Rápido

Instalação

Usando uv (recomendado):

uv pip install mcp-server-make

Usando pip:

pip install mcp-server-make

Uso Básico

# Run with default Makefile in current directory
uvx mcp-server-make

# Run with specific Makefile and working directory
uvx mcp-server-make --make-path /path/to/Makefile --working-dir /path/to/working/dir

Configuração do Cliente MCP

Para usar com o Claude Desktop, adicione à sua configuração do Claude (claude_desktop_config.json):

{
  "mcpServers": {
    "make": {
      "command": "uvx",
      "args": [
        "mcp-server-make",
        "--make-path", "/absolute/path/to/Makefile",
        "--working-dir", "/absolute/path/to/working/dir"
      ]
    }
  }
}

Documentação

Para informações detalhadas sobre o uso do MCP Server Make, consulte nossa documentação:

Guia do Usuário - Guia completo de instalação, configuração e uso
Makefiles Personalizados - Criando Makefiles eficazes para uso com o MCP Server Make

Aprimorando Fluxos de Trabalho de Desenvolvimento

Este servidor possibilita fluxos de trabalho de desenvolvimento poderosos ao dar aos LLMs acesso direto à funcionalidade make:

Para Desenvolvedores

Assistência Automatizada
- Deixe o Claude executar e interpretar resultados de testes
- Obtenha sugestões e melhorias para o sistema de build
- Automatize tarefas repetitivas de desenvolvimento
Gerenciamento de Projetos
- Deixe o Claude lidar com atualizações de dependências
- Automatize processos de release
- Mantenha qualidade de código consistente

Trabalhando com Alvos Make

O MCP Server Make não descobre automaticamente os alvos disponíveis no seu Makefile. Para usá-lo efetivamente com o Claude:

Comece com make help: A maioria dos Makefiles bem projetados inclui um alvo de ajuda
```
Human: Please run make help to see what commands are available.
```
Informe o Claude sobre seus alvos: Mencione explicitamente os alvos disponíveis e sua finalidade
```
Human: Our project has these make targets: test, lint, format, build, and clean.
```
Use convenções padrão: Alvos comuns que muitos Makefiles incluem:
- make test - Executar testes
- make lint - Verificar qualidade do código
- make format - Formatar código
- make build - Compilar o projeto
- make clean - Limpar artefatos de build

O repositório inclui um Makefile opinativo com alvos utilitários adicionais - consulte o Guia do Usuário para detalhes sobre esses recursos estendidos ou para criar seus próprios alvos personalizados.

Nota: O Claude não lembra dos alvos disponíveis entre conversas. Você precisará apresentá-los no início de cada conversa.

Exemplo de Integração

Veja como o Claude pode ajudar com tarefas de desenvolvimento:

Human: Can you run our test suite and format any code that needs it?

Claude: I'll help run the tests and format the code:

1. First, let's format the code:
[Calling make tool with args {"target": "format"}]
2 files reformatted, 3 files left unchanged

2. Now let's run the tests:
[Calling make tool with args {"target": "test"}]
Running tests...
4 passed, 0 failed

All formatting and tests completed successfully. The code is now properly formatted and all tests are passing.

Ferramentas Disponíveis

O servidor expõe uma única ferramenta:

make - Executar um alvo make do Makefile
- target (string, obrigatório): Nome do alvo a executar

Contribuindo

Aceitamos contribuições para melhorar o mcp-server-make! Consulte CONTRIBUTING.md para instruções detalhadas sobre como configurar seu ambiente de desenvolvimento, usar as ferramentas do projeto e enviar alterações.

Licença

Licença MIT - consulte o arquivo LICENSE para detalhes