xMCP Server

Un servidor MCP HTTP transmisible que envía solicitudes a servidores MCP stdio dentro de un contenedor, proporcionando un entorno de comandos consistente.

Documentación

xMCP Server

xMCP es un servidor MCP HTTP transmisible que actúa como proxy de solicitudes hacia servidores MCP stdio.

Ya existen múltiples servidores proxy MCP, pero ninguno resuelve el siguiente problema:

¿Qué pasa si el servidor MCP stdio que quiero usar utiliza un comando que no está disponible en mi sistema?

¡La respuesta es usar xMCP!

Cómo funciona

Considera el siguiente ejemplo:

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp"]
    }
  }
}

Este comando solo funcionará si tienes npx instalado.

Para usar este servidor MCP, transfórmalo de la siguiente manera:

http://localhost:3001/mcp?name=context7&command=npx&args=-y,@upstash/context7-mcp

Al enviar esta solicitud a través de la red, podrás usar el servidor MCP stdio context7 a través de la red.

¿Por qué funciona?

xMCP se ejecuta dentro de un contenedor con los comandos más comunes preinstalados. ¡Agrega lo que necesites al contenedor y listo! (Y considera crear un PR si crees que otros también se beneficiarían de ello).

Comandos disponibles

  • npx
  • bunx
  • uv
  • docker

Cómo usar

Desarrollo Local

docker compose up -d

# or

make start

El servidor se ejecuta en http://localhost:3001/mcp.

El inspector se ejecuta en http://localhost:6274, sin embargo, requiere que se establezca un token en la URL.

Ejecuta make logs, obtén la URL con el token de autenticación y ábrela.