MCP Advisor

Accede a la especificación del Protocolo de Contexto del Modelo a través de indicaciones y recursos.

GitHub
25
Prueba este MCPPatrocinado

Documentación

MCP Advisor

⚠️Advertencia: actualmente este servidor depende del archivo oficial LLMS.txt que ya no coincide con el formato esperado por este servidor. Este servidor también necesita actualizarse para la última especificación. Por el momento, recomiendo usar el servidor de documentación oficial y apuntar a los esquemas en el repositorio de MCP.

Un servidor MCP que proporciona acceso integral a la especificación del Model Context Protocol tanto a través de prompts como de recursos. Este servidor ayuda a los LLM y a los humanos a comprender y trabajar con la especificación MCP proporcionando el esquema JSON completo y documentación detallada.

¿Cuándo usaría este tipo de solución en lugar de la búsqueda web u otras soluciones RAG?

Aunque la misma información ya está disponible en la web, si tiene un caso de uso donde se prefiere información precisa de la especificación, obtener directamente los detalles de la especificación como contexto debería proporcionar un resultado más fiable.

Dado que estos recursos deberían caber fácilmente en la ventana de contexto de un modelo, no es realmente necesario utilizar una solución RAG más compleja a menos que necesite comparar documentos con otros documentos o realizar tipos de consultas más complejas.

Otras formas de hacer lo mismo

Si prefiere un enfoque más ad-hoc, también puede usar un servidor MCP como fetch para hacer lo siguiente:

  1. Obtener el contenido de https://modelcontextprotocol.io/llms.txt para obtener la lista de enlaces válidos
  2. Obtener contenido de los enlaces que sean relevantes para la tarea actual

Instalación

# Install as a dependency
npm install mcp-advisor

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

Uso

Con Claude Desktop

  1. Agregue lo siguiente a su archivo de configuración de 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. El servidor proporciona las siguientes capacidades:

Prompts

  • explain: Explicación completa de los temas de MCP con contexto de documentación completo.
    • Argumento requerido: topic - Especifica qué tema de MCP desea que se explique en detalle.
    • Argumento opcional: version - Especifica qué versión de la especificación MCP usar. Versiones compatibles: draft, 2024-11-05, 2025-03-26, 2025-06-18 (predeterminada).
  • evaluate_server_compliance: Evalúa el cumplimiento de la especificación del Model Context Protocol (MCP) para un repositorio de servidor determinado.
    • Argumento requerido: path - Especifica la ruta al repositorio del servidor MCP a evaluar.
    • Argumento opcional: version - Especifica qué versión de la especificación MCP usar. Versiones compatibles: draft, 2024-11-05, 2025-03-26, 2025-06-18 (predeterminada).

Recursos

El servidor proporciona acceso a diferentes secciones de la especificación y documentación de MCP:

Recursos de especificación

  • Especificación completa: La especificación completa del Model Context Protocol, incluyendo esquema, arquitectura, protocolo base, utilidades, características del servidor y características del cliente
  • Especificación del esquema: La especificación completa del esquema JSON del Model Context Protocol
  • Descripción general de la arquitectura: Descripción general de la arquitectura del Model Context Protocol
  • Protocolo base: Detalles del protocolo central, incluyendo transportes, autorización y ciclo de vida
  • Utilidades: Documentación para las funciones de Ping, Cancelación y Reporte de Progreso
  • Características del servidor: Guía completa de Prompts, Recursos, Herramientas y Utilidades del servidor, incluyendo finalización, registro y paginación
  • Características del cliente: Información sobre las capacidades de Roots y Sampling

Todos los recursos de especificación se pueden acceder con un parámetro de versión específico.

Plantillas de recursos

El servidor proporciona plantillas de recursos que permiten acceder a los recursos de especificación para diferentes versiones:

  • https://modelcontextprotocol.io/specification/{version}/index.md: Acceda a la especificación completa para cualquier versión compatible
  • https://modelcontextprotocol.io/specification/{version}/schema.json: Acceda al esquema JSON para cualquier versión compatible
  • https://modelcontextprotocol.io/specification/{version}/architecture/index.md: Acceda a la especificación de arquitectura para cualquier versión compatible
  • https://modelcontextprotocol.io/specification/{version}/basic/index.md: Acceda a la especificación del protocolo base para cualquier versión compatible
  • https://modelcontextprotocol.io/specification/{version}/basic/utilities/index.md: Acceda a la especificación de utilidades para cualquier versión compatible
  • https://modelcontextprotocol.io/specification/{version}/server/index.md: Acceda a la especificación de características del servidor para cualquier versión compatible
  • https://modelcontextprotocol.io/specification/{version}/client/index.md: Acceda a la especificación de características del cliente para cualquier versión compatible

Versiones compatibles: draft, 2024-11-05, 2025-03-26, 2025-06-18 (predeterminada)

Configuración de versión:

  • Plantillas de recursos: Los clientes que admiten Plantillas de recursos pueden especificar la versión en la plantilla de URI.
  • Variable de entorno: Establezca la variable de entorno DEFAULT_SPEC_VERSION para cambiar la versión predeterminada (por ejemplo, DEFAULT_SPEC_VERSION=draft).
  • Versión predeterminada: Si no se especifica ninguna de las anteriores, el servidor usa 2025-06-18 como versión predeterminada.

Nota sobre compatibilidad hacia atrás: Los clientes que solo admiten Recursos (y no Plantillas de recursos) aún podrán acceder a los Recursos regulares usando la versión predeterminada configurada. El servidor mantiene total compatibilidad hacia atrás con los clientes existentes.

Recursos de documentación adicionales

  • Primeros pasos (/quickstart): Guías de inicio para desarrolladores de clientes, desarrolladores de servidores y usuarios
  • Desarrollo (/development): Recursos de desarrollo, incluyendo pautas de contribución, hoja de ruta y actualizaciones
  • Documentación del SDK (/sdk): Documentación del SDK para varios lenguajes de programación
  • Tutoriales y ejemplos (/tutorials): Tutoriales, ejemplos y guías de implementación
  • Documentación general (/docs): Documentación general, incluyendo preguntas frecuentes, introducción y lista de clientes
  • Documentación de la comunidad (/community): Pautas de la comunidad, incluyendo Pautas SEP, Comunicación y Gobernanza
  • Guía de primeros pasos (/docs/getting-started): Introducción y primeros pasos con MCP
  • Recursos de aprendizaje (/docs/learn): Descripción general de la arquitectura y conceptos centrales
  • Herramientas de depuración de MCP (/legacy/tools): Herramientas de depuración, incluyendo el Inspector de MCP
  • Descripción general de MCP (/overview): Descripción general de alto nivel del Model Context Protocol

Todo el contenido de la especificación se obtiene de una lista proporcionada por un archivo llms.txt estandarizado (excepto el schema.json que se obtiene de GitHub) y se almacena en caché localmente con un TTL (tiempo de vida) de 1 hora para mejorar el rendimiento. Si una obtención falla, el servidor intentará usar el contenido en caché caducado como respaldo cuando esté disponible.

Desarrollo

# 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

Prueba del filtrado de URL y soporte de versiones

El servidor incluye filtrado de URL para garantizar que se incluya el contenido que coincida con la versión solicitada:

npm run test

Esto verifica que el servidor filtra correctamente las URL de especificación según la versión solicitada. El servidor admite múltiples versiones, incluyendo draft, 2024-11-05, 2025-03-26 y 2025-06-18, siendo 2025-06-18 la predeterminada si no se especifica ninguna versión.

Enlaces