Code Research MCP Server

Code Research MCP Server

Um servidor Model Context Protocol que fornece ferramentas para pesquisar e acessar recursos de programação em múltiplas plataformas. Este servidor integra-se com plataformas populares de desenvolvedores para ajudar LLMs a encontrar exemplos de código, documentação e pacotes relevantes.

Recursos

Plataformas Integradas

• Stack Overflow - Perguntas e respostas de programação
• MDN Web Docs - Documentação de desenvolvimento web
• GitHub - Pesquisa de código e repositórios
• npm - Registro de pacotes JavaScript
• PyPI - Índice de pacotes Python

Ferramentas

search_stackoverflow

Pesquise no Stack Overflow por perguntas e respostas de programação.

• Parâmetros:
  • query (obrigatório): String de consulta de pesquisa
  • limit (opcional): Máximo de resultados (1-10, padrão: 5)
• Retorna: Lista formatada de perguntas com pontuações, contagens de respostas e trechos
• Os resultados são armazenados em cache por 1 hora

search_mdn

Pesquise no MDN Web Docs por documentação de desenvolvimento web.

• Parâmetros:
  • query (obrigatório): String de consulta de pesquisa
• Retorna: As 5 principais correspondências de documentação do MDN com resumos e links
• Os resultados são armazenados em cache por 1 hora

search_github

Pesquise no GitHub por repositórios e exemplos de código.

• Parâmetros:
  • query (obrigatório): String de consulta de pesquisa
  • language (opcional): Filtrar por linguagem de programação
  • limit (opcional): Máximo de resultados por categoria (1-10, padrão: 5)
• Retorna: Duas seções:
  1. Principais repositórios ordenados por estrelas
  2. Arquivos de código relevantes com contexto do repositório
• Os resultados são armazenados em cache por 1 hora

search_npm

Pesquise no registro npm por pacotes JavaScript.

• Parâmetros:
  • query (obrigatório): String de consulta de pesquisa
  • limit (opcional): Máximo de resultados (1-10, padrão: 5)
• Retorna: Informações do pacote incluindo versão, descrição e estatísticas de download
• Os resultados são armazenados em cache por 1 hora

search_pypi

Pesquise no PyPI por pacotes Python.

• Parâmetros:
  • query (obrigatório): String de consulta de pesquisa
• Retorna: Informações detalhadas do pacote incluindo versão, autor e links
• Os resultados são armazenados em cache por 1 hora

search_all

Pesquise em todas as plataformas simultaneamente para obter resultados abrangentes.

• Parâmetros:
  • query (obrigatório): String de consulta de pesquisa
  • limit (opcional): Máximo de resultados por plataforma (1-5, padrão: 3)
• Retorna: Resultados combinados de todas as plataformas:
  1. Perguntas e respostas do Stack Overflow
  2. Documentação do MDN
  3. Repositórios e código do GitHub
  4. Pacotes npm
  5. Pacotes PyPI
• Os resultados são armazenados em cache por 1 hora
• Nota: Executa todas as pesquisas em paralelo para resposta mais rápida

Requisitos

• Node.js >= 20.11.0
• npm >= 10.0.0
• Opcional: Token de acesso pessoal do GitHub para limites de taxa de API mais altos

Instalação

Instalação via Smithery

Para instalar o Code Research Server para Claude Desktop automaticamente via Smithery:

npx -y @smithery/cli install @nahmanmate/code-research-mcp-server --client claude

Instalação Manual

1. Clone o repositório e instale as dependências:

git clone https://github.com/nahmanmate/code-research-mcp-server.git
cd code-research-server
npm install

2. Compile o servidor:

npm run build

3. Configure as Configurações do MCP:

Adicione a configuração do servidor ao seu arquivo de configurações do MCP:

• VSCode: ~/.vscode-server/data/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json
• Claude Desktop:
  • MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "code-research": {
      "command": "node",
      "args": ["/absolute/path/to/code-research-mcp-server/build/index.js"],
      "env": {
        "GITHUB_TOKEN": "your_github_token"  // Optional: Prevents rate limiting
      },
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

Nota: Substitua /absolute/path/to pelo caminho real onde você clonou o repositório.

Desenvolvimento

Executando em Modo de Desenvolvimento

Para desenvolvimento com recompilação automática em alterações:

npm run watch

Tratamento de Erros

O servidor implementa tratamento robusto de erros:

• Mensagens de erro específicas da API para cada plataforma
• Tratamento de limite de taxa para a API do GitHub
• Fallbacks graciosos para indisponibilidade de serviço
• Respostas em cache para reduzir a carga da API

Depuração

Como os servidores MCP se comunicam via stdio, a depuração pode ser desafiadora. Use o MCP Inspector para monitoramento detalhado de requisições/respostas:

npm run inspector

O Inspector fornece:

• Monitoramento de requisições/respostas em tempo real
• Rastreamento de execução de ferramentas
• Rastreamentos de pilha de erros
• Métricas de desempenho

Visite a URL fornecida no seu navegador para acessar a interface de depuração.

Cache

Os resultados são armazenados em cache usando node-cache:

• TTL padrão: 1 hora
• Chaves de cache separadas por combinação de consulta/limite
• Estratégias de cache específicas por plataforma
• Armazenamento eficiente em memória

Contribuindo

1. Faça um fork do repositório
2. Crie um branch de funcionalidade
3. Faça commit das suas alterações
4. Envie para o branch
5. Crie um Pull Request

Licença

AGPLv3