mcphub

MCPHub: El centro unificado para servidores de Protocolo de Contexto de Modelo (MCP)

MCPHub facilita la administración y el escalamiento de múltiples servidores MCP (Protocolo de contexto de modelo) organizándolos en puntos finales Streamable HTTP (SSE) flexibles, lo que admite el acceso a todos los servidores, servidores individuales o grupos de servidores lógicos.

Vista previa del panel

🚀 Características

Compatibilidad ampliada con servidores MCP : integre sin problemas cualquier servidor MCP con una configuración mínima.
Panel centralizado : supervise el estado y las métricas de rendimiento en tiempo real desde una elegante interfaz de usuario web.
Manejo de protocolo flexible : compatibilidad total con los protocolos stdio y SSE MCP.
Configuración intercambiable en caliente : agregue, elimine o actualice servidores MCP sobre la marcha, sin necesidad de tiempo de inactividad.
Control de acceso basado en grupos : organice los servidores en grupos personalizables para una gestión optimizada de permisos.
Autenticación segura : gestión de usuarios integrada con acceso basado en roles impulsado por JWT y bcrypt.
Docker-Ready : Implemente instantáneamente con nuestra configuración en contenedores.

🔧 Inicio rápido

Configuración opcional

Cree un archivo mcp_settings.json para personalizar la configuración de su servidor:

{
  "mcpServers": {
    "amap": {
      "command": "npx",
      "args": ["-y", "@amap/amap-maps-mcp-server"],
      "env": {
        "AMAP_MAPS_API_KEY": "your-api-key"
      }
    },
    "playwright": {
      "command": "npx",
      "args": ["@playwright/mcp@latest", "--headless"]
    },
    "fetch": {
      "command": "uvx",
      "args": ["mcp-server-fetch"]
    },
    "slack": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-slack"],
      "env": {
        "SLACK_BOT_TOKEN": "your-bot-token",
        "SLACK_TEAM_ID": "your-team-id"
      }
    }
  }
}

Implementación de Docker

Recomendado : Monte su configuración personalizada:

docker run -p 3000:3000 -v $(pwd)/mcp_settings.json:/app/mcp_settings.json samanhappy/mcphub

o ejecutar con la configuración predeterminada:

docker run -p 3000:3000 samanhappy/mcphub

Acceder al panel de control

Abra http://localhost:3000 e inicie sesión con sus credenciales.

Nota : Las credenciales predeterminadas son admin / admin123 .

Descripción general del panel de control :

Estado en vivo de todos los servidores MCP
Habilitar/deshabilitar o reconfigurar servidores
Gestión de grupos para organizar servidores
Administración de usuarios para el control de acceso

Punto final HTTP transmisible

Actualmente, la compatibilidad con los endpoints HTTP de streaming varía según el cliente de IA. Si tiene problemas, puede usar el endpoint SSE o esperar a futuras actualizaciones.

Conectar clientes de IA (por ejemplo, Claude Desktop, Cursor, DeepChat, etc.) a través de:

http://localhost:3000/mcp

Este punto final proporciona una interfaz HTTP unificada y transmisible para todos sus servidores MCP. Le permite:

Enviar solicitudes a cualquier servidor MCP configurado
Reciba respuestas en tiempo real
Se integra fácilmente con varios clientes y herramientas de IA
Utilice el mismo punto final para todos los servidores, lo que simplifica su proceso de integración

Puntos finales específicos del grupo (recomendados) :

Gestión de grupos

Para obtener acceso específico a grupos de servidores, utilice el punto final HTTP basado en grupo:

http://localhost:3000/mcp/{group}

Donde {group} es el ID o nombre del grupo que creaste en el panel. Esto te permite:

Conectarse a un subconjunto específico de servidores MCP organizados por caso de uso
Aislar diferentes herramientas de IA para acceder solo a los servidores relevantes
Implementar un control de acceso más granular para diferentes entornos o equipos

Puntos finales específicos del servidor : para acceder directamente a servidores individuales, utilice el punto final HTTP específico del servidor:

http://localhost:3000/mcp/{server}

Donde {server} es el nombre del servidor al que desea conectarse. Esto le permite acceder directamente a un servidor MCP específico.

Nota : Si el nombre del servidor y el nombre del grupo son los mismos, el nombre del grupo tendrá prioridad.

Punto final de SSE (obsoleto en el futuro)

Conectar clientes de IA (por ejemplo, Claude Desktop, Cursor, DeepChat, etc.) a través de:

http://localhost:3000/sse

Para obtener acceso específico a grupos de servidores, utilice el punto final SSE basado en grupos:

http://localhost:3000/sse/{group}

Para acceder directamente a servidores individuales, utilice el punto final SSE específico del servidor:

http://localhost:3000/sse/{server}

🧑‍💻 Desarrollo Local

git clone https://github.com/samanhappy/mcphub.git
cd mcphub
pnpm install
pnpm dev

Esto inicia tanto el frontend como el backend en modo de desarrollo con recarga en caliente.

Para los usuarios de Windows, es posible que necesite iniciar el servidor backend y el frontend por separado: pnpm backend:dev , pnpm frontend:dev .

🛠️ Problemas comunes

Usando Nginx como proxy inverso

Si está utilizando Nginx como proxy inverso de MCPHub, asegúrese de agregar la siguiente configuración en su configuración de Nginx:

proxy_buffering off

🔍 Pila tecnológica

Backend : Node.js, Express, TypeScript
Interfaz : React, Vite, Tailwind CSS
Autorización : JWT y bcrypt
Protocolo : SDK de protocolo de contexto de modelo

👥 Contribuyendo

¡Contribuciones de cualquier tipo son bienvenidas!

Nuevas funciones y optimizaciones
Mejoras en la documentación
Informes de errores y correcciones
Traducciones y sugerencias

Bienvenido a unirte a nuestra comunidad de Discord para debates y apoyo.

❤️ Patrocinador

Si te gusta este proyecto quizás puedas considerar:

Historia de las estrellas

📄 Licencia

Con licencia Apache 2.0 .