pluggedin-mcp-proxy

Servidor proxy MCP enchufado

📋 Descripción general

El servidor proxy MCP de plugged.in es un potente middleware que integra varios servidores MCP (Protocolo de Contexto de Modelo) en una única interfaz unificada. Obtiene las configuraciones de herramientas, indicaciones y recursos de la aplicación de plugged.in y enruta las solicitudes de forma inteligente a los servidores MCP subyacentes correspondientes.

Este proxy permite una integración perfecta con cualquier cliente MCP (Claude, Cline, Cursor, etc.) al tiempo que proporciona capacidades de gestión avanzadas a través del ecosistema plugged.in.

✨ Características principales

• Compatibilidad universal con MCP : funciona con cualquier cliente MCP, incluidos Claude Desktop, Cline y Cursor
• Compatibilidad con múltiples servidores : conecte servidores MCP STDIO (línea de comandos) y WebSocket (basados en HTTP)
• Aislamiento del espacio de nombres : mantenga los MCP unidos separados y organizados con el prefijo adecuado
• Capa de múltiples espacios de trabajo : cambie entre diferentes conjuntos de configuraciones de MCP con un solo clic
• Arquitectura simplificada : base de código optimizada con tiempo de inicio mejorado y complejidad reducida
• Proxy impulsado por API : obtiene capacidades de las API de aplicaciones conectadas en lugar del descubrimiento directo
• Soporte completo para MCP : maneja herramientas, recursos, plantillas de recursos y avisos
• Instrucciones personalizadas : admite instrucciones específicas del servidor formateadas como indicaciones MCP

🚀 Inicio rápido

Prerrequisitos

• Node.js 18+ (recomendado v20+)
• Una clave API de la aplicación plugged.in (obtenga una en plugged.in/api-keys )

Instalación

Configuración para clientes MCP

Escritorio de Claude

Agregue lo siguiente a su configuración de Claude Desktop:

Cline

Agregue lo siguiente a su configuración de Cline:

Cursor

Para Cursor, puede utilizar argumentos de línea de comandos en lugar de variables de entorno:

⚙️ Opciones de configuración

Variables de entorno

Argumentos de la línea de comandos

Los argumentos de la línea de comandos tienen prioridad sobre las variables de entorno:

Para obtener una lista completa de opciones:

🐳 Uso de Docker

También puedes construir y ejecutar el servidor proxy usando Docker.

Construyendo la imagen

Asegúrate de tener Docker instalado y en ejecución. Accede al directorio pluggedin-mcp y ejecuta:

Se incluye un archivo .dockerignore para optimizar el contexto de compilación.

Ejecución del contenedor

Ejecute el contenedor, proporcionando las variables de entorno necesarias:

Reemplace YOUR_API_KEY y YOUR_API_BASE_URL (si no usa el valor predeterminado https://plugged.in ).

Pruebas con MCP Inspector

Mientras el contenedor esté en ejecución, puedes conectarte a él mediante el Inspector MCP:

Esto se conectará a la entrada/salida estándar del contenedor en ejecución.

Detener el contenedor

Presione Ctrl+C en la terminal donde se ejecuta docker run . El indicador --rm garantiza que el contenedor se elimine automáticamente al detenerse.

🏗️ Arquitectura del sistema

El servidor proxy MCP conectado actúa como un puente entre los clientes MCP y varios servidores MCP subyacentes:

🔄 Flujo de trabajo

1. Configuración : El proxy obtiene las configuraciones del servidor desde la aplicación conectada
2. Listado de capacidades : el proxy obtiene las capacidades descubiertas de las API de la aplicación conectada.
   • tools/list : Obtiene de /api/tools (devuelve nombres con prefijo)
   • resources/list : Obtiene de /api/resources
   • resource-templates/list : Obtiene datos de /api/resource-templates
   • prompts/list : Obtiene de /api/prompts y /api/custom-instructions , fusiona los resultados
3. Resolución de capacidad : el proxy resuelve las capacidades a los servidores de destino
   • tools/call : analiza el prefijo del nombre de la herramienta y busca el servidor en el mapa interno
   • resources/read : llama a /api/resolve/resource?uri=... para obtener detalles del servidor
   • prompts/get : busca prefijos de instrucciones personalizados o llama a /api/resolve/prompt?name=...
4. Enrutamiento de solicitudes : las solicitudes se enrutan al servidor MCP subyacente apropiado
5. Manejo de respuestas : las respuestas de los servidores subyacentes se devuelven al cliente.

🧩 Integración con la aplicación plugged.in

El servidor proxy MCP plugged.in está diseñado para funcionar sin problemas con la aplicación plugged.in , que proporciona:

• Una interfaz basada en web para administrar las configuraciones del servidor MCP
• Descubrimiento centralizado de capacidades (herramientas, recursos, plantillas, indicaciones)
• Gestión de instrucciones personalizadas
• Compatibilidad con múltiples espacios de trabajo para diferentes conjuntos de configuraciones
• Un patio de juegos interactivo para probar herramientas MCP
• Autenticación de usuarios y gestión de claves API

Recursos relacionados

• Repositorio de aplicaciones plugged.in
• Especificación del Protocolo de Contexto de Modelo (MCP)
• Documentación de escritorio de Claude
• Documentación de Cline

🤝 Contribuyendo

¡Agradecemos sus contribuciones! No dude en enviar una solicitud de incorporación de cambios.

📄 Licencia

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

🙏 Agradecimientos

• Inspirado en el servidor proxy MCP
• Construido sobre el Protocolo de Contexto Modelo