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

Related MCP server: Remote MCP Server on Cloudflare

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

    "remote-example": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "http://localhost:8787/sse",
        "--header",
        "Authorization: Bearer {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.

Conecte Claude Desktop a su servidor MCP remoto

TODO: Necesitamos admitir encabezados arbitrarios para el proxy mcp-remote

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