Consult7 MCP Server

Consult7 MCP Server

Consult7 MCP Server é um servidor do Protocolo de Contexto de Modelo (MCP) que permite a agentes de IA analisar grandes bases de código ou coleções de documentos usando modelos LLM avançados com janelas de contexto enormes, mesmo quando o modelo do agente tem um comprimento de contexto limitado. Ele permite a coleta recursiva de arquivos, suporta vários provedores de IA e integra-se facilmente com Claude Code e Claude Desktop via MCP, por exemplo, para resumir, pesquisar ou referenciar projetos grandes com uma única consulta.

Author: szeider


Ver Protocolo

O que é o Consult7 MCP Server?

Consult7 MCP Server é uma ponte que permite que agentes de modelos de linguagem processem e analisem conjuntos de dados, bases de código ou repositórios de documentos que são grandes demais para caber na janela de contexto usual. Ele utiliza LLMs externos (da OpenRouter, OpenAI ou Google) capazes de lidar com contextos muito maiores, extraindo todos os arquivos relevantes que correspondem a padrões especificados pelo usuário, enviando-os para um modelo de janelas grandes para análise e retornando os resultados diretamente para o agente. O servidor é integrado como uma ferramenta sob o Protocolo de Contexto de Modelo para fácil descoberta e invocação.

Como Configurar

Claude Code:
Adicione o Consult7 via a linha de comando:

claude mcp add -s user consult7 uvx -- consult7 <provedor> <api-key>

Substitua <provedor> por openrouter, google ou openai, e <api-key> pela sua chave de API real.

Claude Desktop:
Edite sua configuração mcpServers:

{
  "mcpServers": {
    "consult7": {
      "type": "stdio",
      "command": "uvx",
      "args": ["consult7", "openrouter", "sua-chave-api"]
    }
  }
}

Substitua o provedor e a chave da API conforme necessário. Não é necessário instalar o servidor manualmente; uvx baixa e executa tudo em um ambiente isolado.

Opção de Linha de Comando:
Você também pode testar a conectividade diretamente:

uvx consult7 <provedor> <api-key> [--test]

O modelo em si é escolhido em cada invocação de ferramenta, não durante a configuração.

Como Usar

  1. Configure o Consult7 em seu ambiente Claude Code ou Desktop conforme descrito acima.
  2. A partir do seu agente de IA, use a ferramenta Consult7 para enviar consultas junto com:
    • O caminho do diretório a ser analisado
    • Um padrão regex para selecionar arquivos (por exemplo, ".*\\.py$" para arquivos Python)
    • Opcional: especifique um modelo particular (com ou sem modo |thinking)
  3. O Consult7 irá coletar recursivamente todos os arquivos correspondentes, juntá-los em um contexto grande, enviar sua consulta e dados para o LLM de grande contexto do provedor selecionado, e retornar a análise ao seu agente.
  4. Exemplo de consultas da linha de comando para testar conexões: 
    uvx consult7 openai <api-key> --test
  5. Para remover o Consult7 do Claude Code: 
    claude mcp remove consult7 -s user

Principais Recursos

  • Ponte contínua de agentes de IA para modelos com janelas de contexto extremamente grandes (mais de 1M tokens)
  • Suporta vários provedores líderes: OpenAI, Google AI (Gemini), OpenRouter
  • Coleta e filtra arquivos recursivamente de qualquer diretório usando padrões regex
  • Retorna respostas do modelo diretamente para seu agente para automação de fluxo de trabalho adicional
  • Pode operar em modo "thinking" ou de raciocínio para análises mais profundas quando suportado
  • Instalação e gerenciamento fáceis através do Claude Code ou Desktop, sem necessidade de configuração manual
  • Descoberta e invocação totalmente compatíveis com ferramentas de cliente MCP

Casos de Uso

  • Resumir Grandes Bases de Código: "Resuma a arquitetura e os principais componentes deste projeto Python" (analisa todos os arquivos .py)
  • Localizar Implementações Específicas: "Encontre a implementação do método authenticate_user e explique como ele lida com a verificação de senhas" (busca em arquivos Python, JavaScript e TypeScript)
  • Análise de Cobertura de Testes: "Liste todos os arquivos de teste e identifique quais componentes não têm cobertura de teste" (busca e referencia arquivos relacionados a testes)
  • Revisão de Segurança: "Analise o fluxo de autenticação e pense passo a passo sobre vulnerabilidades" (pede uma análise profunda com modo |thinking)
  • Extração de Documentação: Extraia resumos de alto nível, TODOs ou documentação de API de pastas de projetos diversas e massivas

FAQ

Q: Quais modelos o Consult7 suporta?
A: O Consult7 suporta os principais LLMs de contexto grande da OpenAI, Google (Gemini) e OpenRouter, incluindo modelos com mais de 1 milhão de tokens de comprimento de contexto. A escolha do modelo é flexível por consulta.

Q: O Consult7 lê e envia meus dados para provedores externos?
A: Sim. Arquivos que correspondem ao seu caminho e padrão são enviados (temporariamente, de forma segura) para o provedor de nuvem escolhido para processamento, dependendo da sua seleção de modelo.

Q: E se minha base de código for maior do que a janela de contexto do modelo grande?
A: O Consult7 tentará montar e enviar o máximo que couber na janela de contexto do modelo selecionado. Para bases de código extremamente grandes, considere restringir padrões ou dividir a análise.

Q: É necessária alguma instalação na minha máquina?
A: Não é necessária instalação manual; uvx cuida do Consult7 em um ambiente isolado automaticamente quando você configura via Claude Code ou Desktop.

Q: Como faço para passar modos especiais como "thinking"?
A: Adicione |thinking ao nome do seu modelo na invocação da sua ferramenta (por exemplo, gemini-2.5-flash|thinking). Alguns modelos também aceitam contagens de tokens de raciocínio personalizadas (raramente necessárias).

Q: Quais provedores e chaves de API posso usar?
A: Você pode usar OpenAI, Google AI (Gemini) ou OpenRouter, mas deve fornecer sua própria chave de API válida para cada um.