Cloudflare MCP Server — Code Mode

Plantilla serverless para construir un servidor remoto Model Context Protocol (MCP) en Cloudflare Workers.

El proyecto está diseñado para code mode: los clientes pueden descubrir capacidades y componer llamadas de herramientas con respuestas estructuradas. La ejecución arbitraria de código no está habilitada en la plantilla inicial; solo debe añadirse después de definir sandbox, autenticación, límites y auditoría.

Objetivos

• Ejecutar en el borde mediante Cloudflare Workers.

• Exponer un endpoint MCP en /mcp.

• Mantener herramientas pequeñas, tipadas y componibles.

• Preparar autenticación OAuth y bindings de Cloudflare.

• Evolucionar hacia una ejecución segura de código en sandbox aislado.

Related MCP server: Adi MCP

Desarrollo local

Requisitos previos: Node.js 18+ y una cuenta de Cloudflare con Workers habilitado.

npm install
npm run dev

El servidor local está disponible en http://localhost:8788/mcp.

Para validar con el MCP Inspector:

npx @modelcontextprotocol/inspector@latest

Despliegue

npx wrangler login
npm run deploy

Después del despliegue, el endpoint será:

https://<worker>.<account>.workers.dev/mcp

Estructura

• src/index.ts: enrutamiento HTTP del Worker.

• src/mcp.ts: servidor MCP y herramientas.

• wrangler.jsonc: configuración del Worker.

• PLAN.md: plan de implementación y criterios de aceptación.

Seguridad

No añadas eval, new Function ni un intérprete de código directamente en el Worker. Para code mode con ejecución real, usa una sandbox apropiada, autenticación fuerte, allowlists de APIs, límites de CPU/memoria/tiempo, aislamiento por usuario y registros sin secretos.

Próximos pasos

Consulta PLAN.md.