mcphub

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

English | Français | 中文版

MCPHub facilita la gestión y el escalado de múltiples servidores MCP (Protocolo de Contexto de Modelo) organizándolos en endpoints HTTP (SSE) flexibles y transmitibles, con soporte para acceder a todos los servidores, a servidores individuales o a grupos lógicos de servidores.

🌐 Demostración en vivo y documentación

• Documentación: docs.mcphub.app

• Entorno de demostración: demo.mcphub.app

Related MCP server: MetaMCP

🚀 Características

• Gestión centralizada: supervisa y controla todos los servidores MCP desde un panel unificado

• Enrutamiento flexible: accede a todos los servidores, a grupos específicos o a servidores individuales mediante HTTP/SSE

• Visibilidad granular de grupos: controla la visibilidad de herramientas, mensajes y recursos de forma independiente para cada servidor dentro de un grupo

• Enrutamiento inteligente: descubrimiento de herramientas impulsado por IA mediante búsqueda semántica vectorial (Más información)

• Proxy de aplicaciones MCP: reenvía de forma transparente aplicaciones MCP interactivas en rutas de servidor único (Más información)

• Compresión de resultados de herramientas: reduce de forma transparente las salidas de texto grandes de las herramientas antes de que lleguen a los clientes

• Configuración intercambiable en caliente: añade, elimina o actualiza servidores sin tiempo de inactividad

• Soporte OAuth 2.0: modos de cliente y servidor para una autenticación segura (Más información)

• Inicio de sesión social: soporte fluido de inicio de sesión con GitHub y Google con integración de Better Auth (requiere modo de base de datos)

• Modo de base de datos: almacena la configuración en PostgreSQL para entornos de producción (Más información)

• Listo para Docker: despliega al instante con una configuración contenerizada

🔧 Inicio rápido

Configuración

Crea un archivo mcp_settings.json:

{
  "mcpServers": {
    "time": {
      "command": "npx",
      "args": ["-y", "time-mcp"]
    },
    "fetch": {
      "command": "uvx",
      "args": ["mcp-server-fetch"]
    }
  }
}

📖 Consulta la Guía de configuración para ver todas las opciones, incluyendo OAuth, variables de entorno y más.

Despliegue con Docker

# Run with custom config (recommended)
docker run -p 3000:3000 -v ./mcp_settings.json:/app/mcp_settings.json -v ./data:/app/data samanhappy/mcphub

# Or run with default settings (also mount ./data so credentials and state survive restarts)
docker run -p 3000:3000 -v ./data:/app/data samanhappy/mcphub

Se publican dos variantes de imagen en samanhappy/mcphub:

• latest: la imagen predeterminada. Incluye Node.js/pnpm, Python, uv/uvx, Git y herramientas de compilación. Cubre la mayoría de los servidores MCP.

• latest-full: la imagen ampliada. Añade el conjunto de herramientas de Rust (Cargo/rustc), Docker Engine y navegadores Playwright (Chrome + Firefox, solo amd64). Úsala para servidores basados en Rust o flujos de trabajo de contenedor dentro de contenedor. Descarga más grande.

Consulta Configuración de Docker para conocer las opciones de compilación y la configuración de Docker-in-Docker.

Acceder al panel

Abre http://localhost:3000 e inicia sesión con el nombre de usuario admin. En el primer inicio, si no se establece la variable de entorno ADMIN_PASSWORD, se genera una contraseña aleatoria que se imprime en los registros del servidor. También puedes preestablecer la contraseña:

# Docker: set admin password via environment variable
docker run -p 3000:3000 -e ADMIN_PASSWORD=your-secure-password samanhappy/mcphub

Consejo: cambia la contraseña de administrador después del primer inicio de sesión por seguridad.

Modo sin interfaz: establece DISABLE_WEB=true para omitir la entrega de la interfaz de usuario del panel incluida y ejecutar MCPHub solo con el backend/API y los endpoints MCP. Esto es útil cuando quieres gestionar servidores directamente desde mcp_settings.json.

Conectar clientes de IA

Conecta clientes de IA (Claude Desktop, Cursor, etc.) mediante:

http://localhost:3000/mcp           # All servers
http://localhost:3000/mcp/{group}   # Specific group
http://localhost:3000/mcp/{server}  # Specific server
http://localhost:3000/mcp/$smart    # Smart routing
http://localhost:3000/mcp/$smart/{group}  # Smart routing within group

Nota de seguridad: los endpoints MCP requieren autenticación de forma predeterminada para evitar una exposición accidental. Para permitir el acceso MCP sin autenticación, desactiva Habilitar autenticación de portador en la sección de claves. Omitir autenticación solo afecta al inicio de sesión del panel. Úsalo solo en entornos de confianza.

📖 Consulta la Referencia de la API para obtener documentación detallada de los endpoints.

Gestionar desde la terminal

El mismo binario mcphub funciona también como CLI para el hub en ejecución, sin necesidad de instalación adicional.

mcphub login --url http://localhost:3000 --username admin
mcphub servers list
mcphub servers add fetch --type stdio --command uvx --arg mcp-server-fetch
mcphub tools list                              # discover what tools are available
mcphub tools get fetch_url                     # see required params + sample command
mcphub call fetch_url url=https://example.com --json
mcphub keys create --name ci --access-type all

También habla con la API pública del mercado (mcphub discover, mcphub install ...) para que la búsqueda de servidores y la instalación con un solo comando funcionen con cualquier hub que tenga la detección habilitada.

📖 Consulta la Guía de CLI para ver todos los subcomandos, perfiles y uso en CI.

📚 Documentación

🧑💻 Desarrollo local

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

El desarrollo local usa admin / admin123 y guarda su copia de configuración editable en data/mcp_settings.dev.json, de modo que el mcp_settings.json del repositorio permanezca sin credenciales.

Para usuarios de Windows, inicia el backend y el frontend por separado: pnpm backend:dev, pnpm frontend:dev

📖 Consulta la Guía de desarrollo para obtener instrucciones detalladas de configuración.

🔍 Pila tecnológica

• Backend: Node.js, Express, TypeScript (ESM)

• Frontend: React, Vite, Tailwind CSS

• Almacenamiento: mcp_settings.json basado en archivos de forma predeterminada; PostgreSQL mediante TypeORM con pgvector para el enrutamiento inteligente

• Autenticación: JWT + bcrypt para cuentas locales; claves de portador; servidor OAuth 2.0 integrado (@node-oauth/oauth2-server); Better Auth opcional para inicio de sesión con GitHub/Google

• Protocolo: SDK de Protocolo de Contexto de Modelo

👥 Contribuciones

¡Las contribuciones son bienvenidas! Únete a nuestra comunidad de Discord para debates y soporte.

❤️ Patrocinador

🌟 Historial de estrellas

📄 Licencia

Bajo la Licencia Apache 2.0.