mcp-hub
Puerta de enlace MCP que gestiona múltiples servidores stdio desde un único contenedor con enrutamiento por path, OAuth 2.1 y compatibilidad dual con revisiones del protocolo.
Ficha actualizada 24 sept 2026, 6:37 · upstream 24 sept 2026, 6:23 · release v0.11.3
Qué es mcp-hub
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
mcp-hub es una puerta de entrada para el Protocolo de Contexto de Modelo (MCP) que permite ejecutar múltiples servidores MCP mediante stdin/stdout desde un único contenedor publicado sobre HTTPS. El sistema implementa enrutamiento basado en path y soporta ambas revisiones del protocolo MCP: 2026-07-28 con elicitation y subscriptions, y 2025-11-25.
- Centralizar múltiples servidores MCP (audiobookshelf-mcp, caldav-mcp, calibreweb-mcp) en un único endpoint HTTPS para clientes que no pueden spawnar procesos locales
- Gestionar autenticación OAuth 2.1 con Client ID Metadata Document para ChatGPT connectors, Claude on the Web, Cursor y otros clientes MCP
- Filtrar herramientas por servidor mediante allowTools/denyTools para exponer solo las funcionalidades necesarias a cada cliente
- Reducir consumo de recursos con servidores que se inactivan tras 60 minutos de inactividad manteniendo snapshots persistentes
- Soportar clientes Streamable-HTTP y stdio simultáneamente mediante endpoints /hub, /<name>/mcp y --stdio
- Configuración idéntica al formato mcpServers de Claude Code sin modificaciones
- Enrutamiento por path con meta-tools en /hub: list_servers, list_tools, get_tool_schema, call_tool, wake_server, sleep_server
- OAuth 2.1 CIMD-first con soporte para private_key_jwt y RFC 7591 dinámico
- Supervisión automática con reinicio por backoff exponencial cuando los servidores hijos fallan
- Hot reload de mcp.json que solo afecta a los servidores modificados sin recargar todo el proceso
- Estados persistentes en archivo JSON bajo /data sin base de datos externa
- No incluye docker-compose, requiere configuración manual del entorno
- Soporte limitado a servidores MCP que implementen el formato stdio o HTTP Streamable
- Requiere Node.js y Python como frameworks de ejecución según análisis técnico
- Los clientes que no pueden hacer OAuth requieren tokens API de larga duración manuales
- Sin soporte para bases de datos, todo el estado reside en archivos JSON locales
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Despliegue con docker run o docker compose. Portos 7690 y 80 disponibles. Requiere /data persistente para claves de firma y estado. Configurar IDLE_TIMEOUT_MINUTES=0 para evitar suspensión automática. Usar mcp-hub-admin para gestión manual de upstreams OAuth. Compatible con Raspberry Pi según documentación oficial.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.