MCP Advisor

Acesse a especificação do Model Context Protocol por meio de prompts e recursos.

GitHub
25
Experimente este MCPPatrocinado

Documentação

MCP Advisor

⚠️Aviso: atualmente este servidor depende do arquivo oficial LLMS.txt, que não corresponde mais ao formato esperado por este servidor. Este servidor também precisa ser atualizado para a especificação mais recente. Por enquanto, recomendo usar o servidor de documentação oficial e apontar para os schemas no repositório MCP.

Um servidor MCP que fornece acesso abrangente à especificação do Model Context Protocol por meio de prompts e recursos. Este servidor ajuda LLMs e humanos a entender e trabalhar com a especificação MCP, fornecendo o schema JSON completo e documentação detalhada.

Quando eu usaria esse tipo de solução em vez de pesquisa na web ou outras soluções RAG?

Embora as mesmas informações já estejam disponíveis na web, se você tiver um caso de uso em que informações precisas da especificação sejam preferidas, buscar diretamente os detalhes da especificação como contexto deve fornecer um resultado mais confiável.

Como esses recursos devem caber facilmente na janela de contexto de um modelo, usar uma solução RAG mais complexa não é realmente necessário, a menos que você precise comparar documentos com outros documentos ou fazer tipos mais complexos de consultas.

Outras maneiras de fazer a mesma coisa

Se você preferir uma abordagem mais ad-hoc, também pode usar um servidor MCP como fetch para fazer o seguinte:

  1. Buscar o conteúdo de https://modelcontextprotocol.io/llms.txt para obter a lista de links válidos
  2. Buscar conteúdo dos links relevantes para a tarefa atual

Instalação

# Install as a dependency
npm install mcp-advisor

# Or install globally to use the CLI
npm install -g mcp-advisor

Uso

Com Claude Desktop

  1. Adicione o seguinte ao seu arquivo de configuração do Claude Desktop:
{
  "mcpServers": {
    "mcp-advisor": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-advisor@latest"
      ],
      "env": {
        "DEFAULT_SPEC_VERSION":"2025-06-18" // Optional - overrides the default version used for static Resources that correspond to a specific MCP version
      }
    }
  }
}
  1. O servidor fornece os seguintes recursos:

Prompts

  • explain: Explicação abrangente de tópicos MCP com contexto completo da documentação.
    • Argumento obrigatório: topic - Especifica qual tópico MCP você gostaria que fosse explicado em detalhes.
    • Argumento opcional: version - Especifica qual versão da especificação MCP usar. Versões suportadas: draft, 2024-11-05, 2025-03-26, 2025-06-18 (padrão).
  • evaluate_server_compliance: Avalia a conformidade com a especificação do Model Context Protocol (MCP) para um determinado repositório de servidor.
    • Argumento obrigatório: path - Especifica o caminho para o repositório do servidor MCP a ser avaliado.
    • Argumento opcional: version - Especifica qual versão da especificação MCP usar. Versões suportadas: draft, 2024-11-05, 2025-03-26, 2025-06-18 (padrão).

Recursos

O servidor fornece acesso a diferentes seções da especificação e documentação MCP:

Recursos da Especificação

  • Especificação Completa: A especificação completa do Model Context Protocol, incluindo schema, arquitetura, protocolo base, utilitários, recursos do servidor e recursos do cliente
  • Especificação do Schema: A especificação completa do schema JSON do Model Context Protocol
  • Visão Geral da Arquitetura: Visão geral da arquitetura do Model Context Protocol
  • Protocolo Base: Detalhes do protocolo central, incluindo transportes, autorização e ciclo de vida
  • Utilitários: Documentação para os recursos de Ping, Cancelamento e Relatório de Progresso
  • Recursos do Servidor: Guia abrangente para Prompts, Recursos, Ferramentas e Utilitários do Servidor, incluindo conclusão, registro e paginação
  • Recursos do Cliente: Informações sobre as capacidades de Roots e Sampling

Todos os recursos da especificação podem ser acessados com um parâmetro de versão específico.

Modelos de Recursos

O servidor fornece modelos de recursos que permitem acessar recursos da especificação para diferentes versões:

  • https://modelcontextprotocol.io/specification/{version}/index.md: Acesse a especificação completa para qualquer versão suportada
  • https://modelcontextprotocol.io/specification/{version}/schema.json: Acesse o schema JSON para qualquer versão suportada
  • https://modelcontextprotocol.io/specification/{version}/architecture/index.md: Acesse a especificação da arquitetura para qualquer versão suportada
  • https://modelcontextprotocol.io/specification/{version}/basic/index.md: Acesse a especificação do protocolo base para qualquer versão suportada
  • https://modelcontextprotocol.io/specification/{version}/basic/utilities/index.md: Acesse a especificação de utilitários para qualquer versão suportada
  • https://modelcontextprotocol.io/specification/{version}/server/index.md: Acesse a especificação de recursos do servidor para qualquer versão suportada
  • https://modelcontextprotocol.io/specification/{version}/client/index.md: Acesse a especificação de recursos do cliente para qualquer versão suportada

Versões suportadas: draft, 2024-11-05, 2025-03-26, 2025-06-18 (padrão)

Configuração de Versão:

  • Modelos de Recursos: Clientes que suportam Modelos de Recursos podem especificar a versão no modelo de URI.
  • Variável de Ambiente: Defina a variável de ambiente DEFAULT_SPEC_VERSION para alterar a versão padrão (por exemplo, DEFAULT_SPEC_VERSION=draft).
  • Versão Padrão: Se nenhuma das opções acima for especificada, o servidor usa 2025-06-18 como versão padrão.

Nota sobre Compatibilidade Retroativa: Clientes que suportam apenas Recursos (e não Modelos de Recursos) ainda poderão acessar os Recursos regulares usando a versão padrão configurada. O servidor mantém compatibilidade retroativa total com clientes existentes.

Recursos Adicionais de Documentação

  • Primeiros Passos (/quickstart): Guias de primeiros passos para desenvolvedores de clientes, desenvolvedores de servidores e usuários
  • Desenvolvimento (/development): Recursos de desenvolvimento, incluindo diretrizes de contribuição, roteiro e atualizações
  • Documentação do SDK (/sdk): Documentação do SDK para várias linguagens de programação
  • Tutoriais e Exemplos (/tutorials): Tutoriais, exemplos e guias de implementação
  • Documentação Geral (/docs): Documentação geral, incluindo FAQs, introdução e lista de clientes
  • Documentação da Comunidade (/community): Diretrizes da comunidade, incluindo Diretrizes SEP, Comunicação e Governança
  • Guia de Primeiros Passos (/docs/getting-started): Introdução e primeiros passos com MCP
  • Recursos de Aprendizagem (/docs/learn): Visão geral da arquitetura e conceitos centrais
  • Ferramentas de Depuração MCP (/legacy/tools): Ferramentas de depuração, incluindo o MCP Inspector
  • Visão Geral do MCP (/overview): Visão geral de alto nível do Model Context Protocol

Todo o conteúdo da especificação é buscado de uma lista fornecida por um arquivo llms.txt padronizado (exceto o schema.json, que é buscado do GitHub) e armazenado em cache localmente com um TTL (tempo de vida) de 1 hora para melhorar o desempenho. Se uma busca falhar, o servidor tentará usar conteúdo em cache expirado como fallback quando disponível.

Desenvolvimento

# Clone the repository
git clone https://github.com/olaservo/mcp-advisor.git
cd mcp-advisor

# Install dependencies
npm install

# Run in development mode
npm run dev

# Build the project
npm run build

# Start the built server
npm start

Testando Filtragem de URL e Suporte a Versões

O servidor inclui filtragem de URL para garantir que o conteúdo correspondente à versão solicitada seja incluído:

npm run test

Isso verifica se o servidor filtra corretamente as URLs da especificação com base na versão solicitada. O servidor suporta múltiplas versões, incluindo draft, 2024-11-05, 2025-03-26 e 2025-06-18, com 2025-06-18 sendo o padrão se nenhuma versão for especificada.

Links