Asesor de MCP

inglés |简体中文

Introducción

MCP Advisor es un servicio de descubrimiento y recomendación que ayuda a los asistentes de IA a explorar servidores del Protocolo de Contexto de Modelo (MCP) mediante consultas en lenguaje natural. Facilita a los usuarios la búsqueda y el uso de herramientas MCP adecuadas para tareas específicas.

Características

• Búsqueda en lenguaje natural : encuentre servicios MCP mediante consultas conversacionales

• Metadatos enriquecidos : obtenga información detallada sobre cada servicio

• Actualizaciones en tiempo real : siempre sincronizado con los últimos servicios de MCP

• Fácil integración : configuración sencilla para cualquier asistente de IA compatible con MCP

• Motor de búsqueda híbrido : capacidades de búsqueda avanzada que combinan búsqueda vectorial y coincidencia de texto

• Compatibilidad con múltiples proveedores : compatibilidad con múltiples proveedores de búsqueda que se ejecutan en paralelo

Navegación de la documentación

• Guía de instalación : instrucciones detalladas de instalación y configuración

• Guía del usuario : Cómo utilizar MCP Advisor

• Documentación de arquitectura : detalles de la arquitectura del sistema

• Detalles técnicos - Características técnicas avanzadas

• Guía para desarrolladores : Configuración del entorno de desarrollo y contribución de código

• Mejores prácticas : estándares de codificación y mejores prácticas para colaboradores

• Solución de problemas : problemas comunes y soluciones

• Proveedores de búsqueda : detalles del proveedor de búsqueda

• Referencia de API - Documentación de API

• Hoja de ruta - Planes de desarrollo futuros

• Pautas de contribución : Cómo contribuir con código

Inicio rápido

Instalación

La forma más rápida es integrar MCP Advisor a través de la configuración de MCP:

Agregue esta configuración al archivo de configuración MCP de su asistente de IA:

• MacOS/Linux: ~/Library/Application Support/Claude/claude_desktop_config.json

• Ventanas: %AppData%\Claude\claude_desktop_config.json

Para conocer más métodos de instalación, consulte la Guía de instalación .

Manifestación

Guía para desarrolladores

Descripción general de la arquitectura

MCP Advisor adopta una arquitectura modular con una clara separación de preocupaciones y principios de programación funcional:

Componentes principales

1. Capa de servicio de búsqueda

   • Interfaz de búsqueda unificada y agregación de proveedores

   • Soporte para múltiples proveedores de búsqueda que se ejecutan en paralelo

   • Opciones de búsqueda configurables (límite, minSimilarity)

2. Proveedores de búsqueda

   • Proveedor Meilisearch : Búsqueda de vectores mediante Meilisearch

   • Proveedor GetMCP : búsqueda de API desde el registro GetMCP

   • Proveedor de Compass : búsqueda de API desde el registro de Compass

   • Proveedor sin conexión : búsqueda híbrida que combina texto y vectores

3. Estrategia de búsqueda híbrida

   • Combinación inteligente de coincidencia de texto y búsqueda vectorial

   • Equilibrio de peso configurable

   • Mecanismos de filtrado adaptativo inteligente

4. Capa de transporte

   • Stdio (predeterminado de CLI)

   • SSE (integración web)

   • Puntos finales de la API REST

Para obtener documentación de arquitectura más detallada, consulte ARCHITECTURE.md .

Aspectos técnicos destacados

Técnicas de búsqueda avanzada

1. Normalización vectorial

   • Todos los vectores están normalizados a la longitud unitaria (magnitud = 1)

   • Garantiza cálculos consistentes de similitud de coseno

   • Mejora la precisión de la búsqueda al centrarse en la dirección en lugar de la magnitud.

2. Ejecución de búsqueda paralela

   • La búsqueda de vectores y la búsqueda de texto se ejecutan en paralelo

   • Aprovecha Promise.all para un rendimiento óptimo

   • Mecanismos de respaldo habilitados si falla alguna búsqueda

3. Fusión de resultados ponderados

   • Pesos configurables entre resultados vectoriales y de texto

   • Predeterminado: similitud vectorial (70%), coincidencia de texto (30%)

Sistema de registro y manejo de errores

MCP Advisor implementa sistemas robustos de registro y manejo de errores:

1. Formato de error contextual

   • Enriquecimiento de objetos de error estandarizado

   • Preservación y formato del seguimiento de la pila

   • Categorización y estandarización de tipos de errores

2. Degradación elegante

   • Estrategias de respaldo de múltiples proveedores

   • Procesamiento de resultados parciales

   • Respuestas predeterminadas para fallos críticos

Para obtener más detalles técnicos, consulte TECHNICAL_DETAILS.md .

Inicio rápido para desarrolladores

Configuración del entorno de desarrollo

1. Clonar el repositorio

2. Instalar dependencias:

   npm install

3. Configurar variables de entorno (ver INSTALLATION.md )

Uso de la biblioteca

Opciones de transporte

MCP Advisor admite múltiples métodos de transporte:

1. Transporte Stdio (predeterminado): adecuado para herramientas de línea de comandos

2. SSE Transport : adecuado para la integración web

3. Transporte REST : proporciona puntos finales de API REST

Para obtener más detalles de desarrollo, consulte DEVELOPER_GUIDE.md .

Pautas de contribución

1. Siga las convenciones de mensajes de confirmación:

   • Utilice tipos en minúsculas (feat, fix, docs, etc.)

   • Escribe mensajes descriptivos en formato de oración.

2. Garantizar la calidad del código:

   • Ejecutar pruebas: npm test

   • Tipos de comprobación: npm run type-check

   • Código de pelusa: npm run lint

Para conocer pautas de contribución detalladas, consulte CONTRIBUTING.md .

Ejemplos de uso

Consultas de ejemplo

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

Ejemplo de respuesta

Para ver más ejemplos, consulte EXAMPLES.md .

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

2. No se obtuvieron resultados

   • Pruebe una consulta más general

   • Comprobar la conexión de red a las API de registro

3. Problemas de rendimiento

   • Considere agregar términos de búsqueda más específicos

   • Comprobar los recursos del servidor (CPU/memoria)

Para obtener más información sobre solución de problemas, consulte TROUBLESHOOTING.md .

Proveedores de búsqueda

MCP Advisor admite varios proveedores de búsqueda que pueden utilizarse simultáneamente:

1. Proveedor de búsqueda de Compass : recupera información del servidor MCP mediante la API de Compass

2. Proveedor de búsqueda GetMCP : utiliza la API GetMCP y la búsqueda vectorial para la coincidencia semántica

3. Proveedor de búsqueda Meilisearch : utiliza Meilisearch para una búsqueda de texto rápida y tolerante a fallos

Para obtener información detallada sobre los proveedores de búsqueda, consulte SEARCH_PROVIDERS.md .

Documentación de la API

Para obtener documentación detallada de la API, consulte API_REFERENCE.md .

Hoja de ruta

MCP Advisor está evolucionando de un simple sistema de recomendaciones a una plataforma inteligente de orquestación de agentes. Nuestra visión es crear un sistema que no solo recomiende los servidores MCP adecuados, sino que también aprenda de las interacciones y ayude a los agentes a planificar y ejecutar tareas complejas de forma dinámica.

Principales fases de desarrollo

1. Optimización de la capacidad de recomendación (segundo y tercer trimestre de 2025)

   • Aceptar comentarios de los usuarios

   • Refinar la eficacia de las recomendaciones

   • Introducir más índices

Para obtener una hoja de ruta detallada, consulte ROADMAP.md .

Pruebas

Utilice el inspector para realizar pruebas:

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.