Gateway de MCP

El Gateway de MCP es la solución de código abierto de Docker para orquestar servidores de Model Context Protocol (MCP). Actúa como un proxy centralizado entre clientes y servidores, gestionando la configuración, las credenciales y el control de acceso.

Cuando se utilizan servidores MCP sin el Gateway de MCP, es necesario configurar las aplicaciones de IA de forma individual para cada caso. Con el Gateway de MCP, configuras las aplicaciones para que se conecten al Gateway. El Gateway se encarga del ciclo de vida del servidor, el enrutamiento y la autenticación en todos los servidores de tus perfiles.

Note

Si utilizas Docker Desktop con el kit de herramientas de MCP habilitado, el Gateway se ejecuta automáticamente en segundo plano. No es necesario iniciarlo ni configurarlo manualmente. Esta documentación es para usuarios que desean comprender cómo funciona el Gateway o ejecutarlo directamente para casos de uso avanzados.

Tip

Los entornos de pruebas de E2B ahora incluyen acceso directo al catálogo de Docker MCP, lo que brinda a los desarrolladores acceso a más de 200 herramientas y servicios para crear y ejecutar agentes de IA sin problemas. Para obtener más información, consulta Entornos de pruebas de E2B.

Cómo funciona

El Gateway de MCP ejecuta servidores MCP en contenedores Docker aislados con privilegios, acceso a la red y uso de recursos restringidos. Incluye capacidades de registro (logging) y seguimiento de llamadas integradas para garantizar una visibilidad y gobernanza completas de la actividad de las herramientas de IA.

El Gateway de MCP gestiona todo el ciclo de vida del servidor. Cuando una aplicación de IA necesita utilizar una herramienta, envía una solicitud al Gateway. El Gateway identifica qué servidor gestiona esa herramienta y, si el servidor aún no se está ejecutando, lo inicia como un contenedor Docker. A continuación, el Gateway inyecta las credenciales requeridas, aplica las restricciones de seguridad y reenvía la solicitud al servidor. El servidor procesa la solicitud y devuelve el resultado a través del Gateway de vuelta a la aplicación de IA.

El Gateway de MCP resuelve un problema fundamental: los servidores MCP son simplemente programas que necesitan ejecutarse en algún lugar. Ejecutarlos directamente en tu máquina implica lidiar con la instalación, las dependencias, las actualizaciones y los riesgos de seguridad. Al ejecutarlos como contenedores gestionados por el Gateway, obtienes aislamiento, entornos consistentes y control centralizado.

El Gateway trabaja con perfiles para determinar qué servidores están disponibles. Cuando ejecutas el Gateway, especificas qué perfil utilizar mediante la bandera --profile para determinar qué servidores se ponen a disposición de los clientes.

Uso

Para usar el Gateway de MCP, necesitarás Docker Desktop con el kit de herramientas de MCP habilitado. Sigue la guía del kit de herramientas de MCP para habilitar y configurar servidores a través de la interfaz de Docker Desktop, o consulta Usar el kit de herramientas de MCP desde la CLI para flujos de trabajo basados en la terminal.

Instalar el Gateway de MCP manualmente

Para Docker Engine sin Docker Desktop, necesitarás descargar e instalar el Gateway de MCP por separado antes de poder ejecutarlo.

1. Descarga el binario más reciente desde la página de versiones de GitHub.

2. Mueve o crea un enlace simbólico del binario al destino correspondiente a tu sistema operativo:

   Sistema operativo	Destino del binario
   Linux	~/.docker/cli-plugins/docker-mcp
   macOS	~/.docker/cli-plugins/docker-mcp
   Windows	%USERPROFILE%\.docker\cli-plugins

3. Haz que los binarios sean ejecutables:

   $ chmod +x ~/.docker/cli-plugins/docker-mcp

Puedes ahora utilizar el comando docker mcp:

docker mcp --help

Información adicional

Para obtener más detalles sobre cómo funciona el Gateway de MCP y las opciones de personalización disponibles, consulta la documentación completa en GitHub.