Criei um Toolkit MCP para Melhorar Agentes de Codificação de IA

Agentes de codificação de IA são úteis, mas ainda têm um hábito frustrante:

Eles adivinham.

Você pergunta algo razoável como:

“Onde validamos a entrada do usuário antes de inserir no banco de dados?”

E em vez de saber onde procurar, o agente começa a ler arquivos um por um.

Em um projeto pequeno, isso é aceitável.

Em uma base de código de produção real com mais de 80.000 linhas, vários engenheiros, decisões antigas, pastas meio renomeadas e anos de contexto acumulado, isso fica bagunçado rapidamente.

O agente lê um punhado de arquivos, atinge limites de contexto e te dá uma resposta que soa confiante, mas aponta para a parte errada da base de código.

Eu cansei disso, então construí um toolkit MCP de código aberto para corrigir isso.

O que eu construí

Eu construí MCP Server Toolkit, uma coleção de quatro servidores do Protocolo de Contexto de Modelo que dão aos agentes de codificação de IA acesso direto às coisas que eles precisam:

• Sua base de código
• Seu banco de dados
• Seus documentos
• Seu histórico do git

Repositório:

https://github.com/naveenayalla1-CS50/mcp-server-toolkit

O objetivo é simples:

Parar de fazer o agente adivinhar. Dê a ele ferramentas que saibam onde procurar.

Por que MCP?

O Protocolo de Contexto de Modelo, ou MCP, permite que agentes de IA chamem ferramentas externas de maneira padronizada.

Em vez de o agente ler arquivos aleatórios e esperar que o contexto certo se encaixe, ele pode chamar uma ferramenta projetada para um propósito como:

search_code("validar entrada do usuário")

E receber de volta caminhos de arquivos, números de linha e contexto relevante.

Isso significa menos palpites errados, menos tokens desperdiçados e respostas muito melhores em grandes bases de código.

Os Quatro Servidores

1. mcp-code-search

Pesquisa em seu repositório e retorna correspondências relevantes com caminhos de arquivos, números de linha e contexto ao redor.

Exemplo:

Você: Encontre todos os lugares onde chamamos sendEmail

Agente chama search_code("sendEmail")

Resultados:
api/users.ts:89
services/email.ts:42
jobs/reminders.ts:117

Ele também inclui ferramentas direcionadas read_file e list_files para que o agente possa inspecionar apenas os arquivos que realmente precisa.

2. mcp-database

Permite que o agente faça perguntas de banco de dados somente leitura em linguagem natural.

Exemplo:

Você: Quantos usuários se inscreveram nos últimos 7 dias?

Agente executa:

SELECT count(*) FROM users
WHERE created_at > now() - interval '7 days';

Ele suporta Postgres e SQLite.

O servidor de banco de dados é somente leitura por padrão. Você deve habilitar explicitamente o modo gravável se quiser gravações.

Esse padrão é importante. Eu não queria que um agente estivesse em qualquer lugar perto de dados de produção com permissões de gravação, a menos que o desenvolvedor permitisse intencionalmente.

3. mcp-docs

Indexa uma pasta de documentos Markdown sem configuração de incorporação e sem API externa.

Você pode apontá-lo para documentos internos, runbooks, referências de API ou notas de projeto.

Exemplo:

Você: O que nosso runbook diz sobre reverter uma implantação?

Agente chama search_docs("rollback deployment")

Resultado:
docs/ops/deploy.md:47
"Para reverter: execute ./scripts/rollback.sh <versão>..."

Ele funciona localmente e não envia seus documentos para lugar nenhum.

4. mcp-git

Permite que o agente consulte o histórico do git, diffs, blame e branches.

Isso é útil quando o agente precisa entender não apenas o que o código faz, mas por que ele mudou.

Exemplo:

Você: Por que essa validação foi adicionada?

Agente verifica o git blame e os commits recentes para aquele arquivo.

Instalação

A maneira mais rápida de começar é:

npx mcp-server-toolkit@latest init

Isso inicia uma configuração interativa.

Escolha os servidores que você deseja, forneça DATABASE_URL se estiver usando o servidor de banco de dados, e ele gera a configuração para Claude Code, Cursor, Windsurf ou qualquer outro cliente compatível com MCP.

Exemplo de configuração manual do Claude:

{
  "servers": {
    "code-search": {
      "command": "npx",
      "args": ["-y", "@mcp-toolkit/code-search", "."]
    },
    "database": {
      "command": "npx",
      "args": ["-y", "@mcp-toolkit/database", "--read-only"],
      "env": {
        "DATABASE_URL": "${DATABASE_URL}"
      }
    },
    "docs": {
      "command": "npx",
      "args": ["-y", "@mcp-toolkit/docs", "./docs"]
    },
    "git": {
      "command": "npx",
      "args":