MCP Advisor

Integrations

  • Provides access to MCP servers listed in the Model Context Protocol GitHub repository, allowing AI assistants to discover available services

  • Uses Mermaid for rendering architecture and data flow diagrams to visualize the MCP Advisor system architecture

  • Incorporates Shields.io badges in the README to display MCP status and links to MCP servers

Asesor de MCP

Asesoramiento e instalación de MCP

Experiencia MCP Advisor

¿Qué es esto?

MCP Advisor es un servicio de descubrimiento y recomendación que te ayuda a explorar los servidores de Protocolo de Contexto de Modelo. Actúa como una guía inteligente que ayuda a los asistentes de IA a encontrar y comprender los servicios MCP disponibles mediante consultas en lenguaje natural , lo que facilita el descubrimiento y el uso de las herramientas adecuadas para tareas específicas.

Características

  • Búsqueda inteligente : encuentre servicios de MCP mediante consultas en lenguaje natural
  • Metadatos enriquecidos : obtenga información detallada sobre cada servicio
  • Actualizaciones en tiempo real : Siempre actualizado con los últimos servicios de MCP
  • Fácil integración : Fácil de integrar con cualquier asistente de IA compatible con MCP
  • Búsqueda vectorial : Desarrollada por OceanBase para una búsqueda semántica de alto rendimiento
  • Arquitectura modular : separación clara de las preocupaciones por la mantenibilidad y la extensibilidad

Arquitectura

Flujo de datos

Inicio rápido

Uso

  1. Clonar el repositorio

o

  1. Utilice npx

Instalación

Para Claude Desktop, edite su archivo claude_desktop_config.json :

MacOS/Linux
code ~/Library/Application\ Support/Claude/claude_desktop_config.json
Ventanas
code $env:AppData\Claude\claude_desktop_config.json

Opciones de transporte

MCP Advisor admite dos métodos de transporte:

1. Transporte de Stdio (predeterminado)

Utilice esto para herramientas de línea de comandos e integraciones directas.

Agregue a la configuración MCP de su asistente de IA para habilitar capacidades de descubrimiento de servicios:

{ "mcpServers": { "mcp-advisor": { "command": "npx", "args": [ "-y", "/path/to/repo/build/index.js" ] } } }
2. Transporte SSE (servidor HTTP)

Úselo para servidores remotos o integraciones web. Inicie el servidor con:

# Start with SSE transport on port 3000 TRANSPORT_TYPE=sse SERVER_PORT=3000 ENABLE_FILE_LOGGING=true node build/index.js

Variables de entorno para la configuración de SSE:

  • TRANSPORT_TYPE : Establezca en sse para utilizar el transporte SSE (el valor predeterminado es stdio)
  • SERVER_PORT : puerto del servidor HTTP (predeterminado: 3000)
  • SERVER_HOST : host del servidor HTTP (predeterminado: localhost)
  • SSE_PATH : ruta del punto final de SSE (predeterminado: /sse)
  • MESSAGE_PATH : Ruta del punto final de los mensajes (predeterminado: /messages)

Conéctese al servidor usando:

  • Punto final SSE: http://localhost:3000/sse
  • Punto final de mensajes: http://localhost:3000/messages?sessionId=<SESSION_ID>
  • Comprobación de estado: http://localhost:3000/health
3. Transporte REST
TRANSPORT_TYPE=rest SERVER_PORT=3000 ENABLE_FILE_LOGGING=true node build/index.js

Ejemplos

Consultas de ejemplo

A continuación se muestran algunos ejemplos de consultas que puede utilizar con MCP Advisor:

"Find an MCP server for natural language processing" "MCP server for financial data analysis" "Recommendation engine MCP server for e-commerce" "MCP server with image recognition capabilities" "Weather data processing MCP server" "Document summarization MCP server"

Ejemplo de respuesta

[ { "title": "NLP Toolkit", "description": "Comprehensive natural language processing toolkit with sentiment analysis, entity recognition, and text summarization capabilities.", "github_url": "https://github.com/example/nlp-toolkit", "similarity": 0.92 }, { "title": "Text Processor", "description": "Efficient text processing MCP server with multilingual support.", "github_url": "https://github.com/example/text-processor", "similarity": 0.85 } ]

Solución de problemas

Problemas comunes

  1. Conexión rechazada
    • Asegúrese de que el servidor se esté ejecutando en el puerto especificado
    • Comprobar la configuración del firewall
    • Verifique que la dirección del host sea correcta
  2. No se obtuvieron resultados
    • Pruebe una consulta más general
    • Verifique la conectividad de la red a la API de registro
    • Verificar que los puntos finales de la API estén configurados correctamente
  3. Caídas de conexión SSE
    • Aumentar la configuración del tiempo de espera del cliente
    • Verifique los registros del servidor para ver si hay mensajes de error
    • Asegúrese de que la configuración de CORS sea adecuada si se conecta desde un navegador
  4. Problemas de rendimiento
    • Considere agregar términos de búsqueda más específicos
    • Comprobar los recursos del servidor (CPU/memoria)
    • Implementar el almacenamiento en caché si se realizan consultas similares con frecuencia

Registros

Para obtener información detallada sobre la solución de problemas, consulte los registros en el directorio logs . Habilite el registro de depuración con:

DEBUG=true node build/index.js

Variables de entorno

MCP Advisor se puede configurar utilizando las siguientes variables de entorno:

VariableDescripciónPor defectoRequerido
TRANSPORT_TYPEMétodo de transporte ( stdio , sse , rest )stdioNo
SERVER_PORTPuerto de servidor HTTP para transporte SSE/REST3000No
SERVER_HOSTHost de servidor HTTP para transporte SSE/RESTlocalhostNo
SSE_PATHRuta del punto final de SSE/sseNo
MESSAGE_PATHRuta del punto final de los mensajes/messagesNo
ENDPOINTRuta del punto final REST/restNo
DEBUGHabilitar el registro de depuraciónfalseNo
ENABLE_FILE_LOGGINGHabilitar el registro en archivosfalseNo
LOG_LEVELNivel de registro (depuración, información, advertencia, error)infoNo

Documentación de la API

Puntos finales de la API REST

OBTENER /health

Punto final de verificación de salud.

Respuesta:

{ "status": "ok", "version": "1.0.0" }
OBTENER /sse

Punto final de eventos enviados por el servidor para establecer una conexión.

Parámetros de consulta:

  • Ninguno

Respuesta:

  • Establece una conexión SSE
PUBLICACIÓN /messages

Punto final para enviar mensajes a una conexión SSE establecida.

Parámetros de consulta:

  • sessionId (cadena, obligatoria): el ID de sesión de la conexión SSE

Cuerpo de la solicitud:

{ "jsonrpc": "2.0", "method": "callTool", "params": { "name": "recommend-mcp-servers", "arguments": { "query": "financial data analysis" } }, "id": "1" }

Respuesta:

{ "jsonrpc": "2.0", "result": { "content": [ { "title": "Financial Analytics MCP", "description": "Comprehensive financial data analysis toolkit", "github_url": "https://github.com/example/financial-mcp", "similarity": 0.95 } ] }, "id": "1" }
POST /rest

Punto final de API REST para solicitudes directas (cuando se utiliza el transporte REST).

Cuerpo de la solicitud:

{ "jsonrpc": "2.0", "method": "callTool", "params": { "name": "recommend-mcp-servers", "arguments": { "query": "financial data analysis" } }, "id": "1" }

Respuesta: Igual que el punto final /messages .

Prueba

con inspector

npx @modelcontextprotocol/inspector

Licencia

Licencia MIT: consulte el archivo LICENCIA para obtener más detalles.

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Un servicio de descubrimiento y recomendación que ayuda a los asistentes de IA a encontrar servidores de protocolo de contexto de modelo según consultas en lenguaje natural.

  1. Asesoramiento e instalación de MCP
    1. Experiencia MCP Advisor
  2. ¿Qué es esto?
    1. Características
      1. Arquitectura
        1. Flujo de datos
      2. Inicio rápido
        1. Uso
        2. Instalación
        3. Opciones de transporte
      3. Ejemplos
        1. Consultas de ejemplo
        2. Ejemplo de respuesta
      4. Solución de problemas
        1. Problemas comunes
        2. Registros
      5. Variables de entorno
        1. Documentación de la API
          1. Puntos finales de la API REST
        2. Prueba
          1. Licencia

            Related MCP Servers

            • A
              security
              A
              license
              A
              quality
              An enhanced Model Context Protocol server that enables AI assistants to interact with ClickUp workspaces, supporting task relationships, comments, checklists, and workspace management through natural language.
              Last updated -
              40
              203
              TypeScript
              MIT License
            • -
              security
              A
              license
              -
              quality
              A Model Context Protocol server enabling AI agents to access and manipulate ServiceNow data through natural language interactions, allowing users to search for records, update them, and manage scripts.
              Last updated -
              9
              Python
              MIT License
            • -
              security
              A
              license
              -
              quality
              A Model Context Protocol server that enables AI agents to query Erick Wendel's talks, blog posts, and videos across different platforms using natural language.
              Last updated -
              55
              TypeScript
              MIT License
            • -
              security
              F
              license
              -
              quality
              A Model Context Protocol server that enables AI assistants to interact with Coolify instances through natural language, allowing management of servers, applications, databases, and deployments.
              Last updated -
              85
              2
              TypeScript

            View all related MCP servers

            ID: lzlc6tbjx6