Servidor MCP remoto en Cloudflare

¡Pongamos en funcionamiento un servidor MCP remoto en Cloudflare Workers con inicio de sesión OAuth incluido!

Desarrollar localmente

# clone the repository
git clone git@github.com:cloudflare/ai.git

# install dependencies
cd ai
npm install

# run locally
npx nx dev remote-mcp-server-bearer-auth

Deberías poder abrir http://localhost:8787/ en tu navegador

Conecte el inspector MCP a su servidor

Para explorar su nueva API de MCP, puede utilizar el Inspector de MCP .

Inícielo con npx @modelcontextprotocol/inspector
Dentro del inspector , cambie el Tipo de transporte a SSE e ingrese http://localhost:8787/sse como la URL del servidor MCP al que conectarse.
Agregue un token portador y haga clic en "Conectar"
Haga clic en "Herramientas de lista"
Ejecute la herramienta "getToken", que debería devolver el encabezado de autorización que configuró en el inspector

Conecte Claude Desktop a su servidor MCP local

{
  "mcpServers": {
    "remote-mcp-server-bearer-auth": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "http://localhost:8787/sse",
        "--header",
        "Authorization: Bearer ${AUTH_TOKEN}"
      ]
    },
    "env": {
      "AUTH_TOKEN": "..."
    }
  }
}

Implementar en Cloudflare

npm run deploy

Llame a su servidor MCP remoto recién implementado desde un cliente MCP remoto

Tal como lo hizo anteriormente en "Desarrollar localmente", ejecute el inspector MCP:

npx @modelcontextprotocol/inspector@latest

Luego ingrese la URL de workers.dev (ej: worker-name.account-name.workers.dev/sse ) de su Worker en el inspector como la URL del servidor MCP al cual conectarse y haga clic en "Conectar".

Ya te has conectado a tu servidor MCP desde un cliente MCP remoto. Puedes pasar un token de portador como se mencionó anteriormente.

Depuración

Si algo sale mal, puede ser útil reiniciar Claude o intentar conectarse directamente a su servidor MCP en la línea de comando con el siguiente comando.

npx mcp-remote http://localhost:8787/sse

En algunos casos excepcionales puede ser útil borrar los archivos agregados a ~/.mcp-auth

rm -rf ~/.mcp-auth

Remote MCP Server on Cloudflare