MCP Routing Gateway

El MCP Routing Gateway es un enrutador sin estado y un proxy puro diseñado para resolver el problema de "los LLM seleccionan herramientas no deseadas por el usuario", que es un problema común al que se enfrentan los agentes de IA convencionales actuales (por ejemplo, Claude Desktop, Cline).

🌟 ¿Por qué MCP Routing Gateway?

Cuando se registran múltiples servidores MCP directamente en un agente de IA estándar, el LLM puede navegar y ejecutar libremente todas las herramientas, lo que supone el riesgo de activar operaciones destructivas inesperadas o llamadas a herramientas innecesarias.

Este proyecto se sitúa entre el agente de IA y el grupo real de servidores MCP, mediando en la comunicación para proporcionar una capa de control que "presenta al LLM solo herramientas curadas de forma segura (filtradas y virtualizadas)".

🏗️ Arquitectura

Este proyecto incorpora internamente funcionalidades tanto de "Servidor MCP" como de "Cliente MCP".

AI Agent (MCP Client) → | [MCP Server] Gateway [MCP Client] | → Backend MCP Servers

Frontend (Servidor MCP): Actúa como un "servidor MCP único y seguro" para el agente de IA, aceptando conexiones a través de entrada/salida estándar (stdio).
Backend (Cliente MCP): Lee mcp_config.json y lanza y gestiona automáticamente múltiples servidores MCP definidos en él (a través de procesos generados por stdio).

🎯 Filosofía de diseño

Este proyecto se basa en la estricta filosofía de ser un "Enrutador y Proxy puro".

Cero interferencia en la carga útil (Pass-through): No interfiere con cargas útiles como IDs de solicitud o argumentos. Se centra totalmente en retransmitir la comunicación, funcionando como una tubería pura.
Patrón de fachada (Filtrado y sustitución de herramientas): El Gateway solo interviene en el enrutamiento de tools/list (presentación de la lista de herramientas) y tools/call (invocación de herramientas). Basándose en el archivo de configuración, oculta herramientas peligrosas o las reemplaza por herramientas virtuales seguras.

⚙️ Configuración

Todas las configuraciones se gestionan completamente en formato JSON. Por defecto, el gateway busca estos archivos en el directorio de trabajo ~/.mcp-gateway. Puede cambiar este directorio utilizando la opción de CLI --work-dir.

mcp_config.json (Definición de Backend): El formato de archivo de configuración estándar para clientes MCP. Define el grupo de servidores MCP a los que se conecta el Gateway y que lanza en segundo plano.
gateway_config.json (Definición de enrutamiento y filtro): Un archivo de configuración de reglas exclusivo del Gateway. Define "qué herramientas ocultar (Herramientas bloqueadas)" y "qué herramientas virtualizar (Herramientas virtuales)".

Para obtener información detallada sobre el uso y las opciones de la CLI, consulte el Manual de usuario.