Servidor MCP en Cloudflare Workers con autenticación de portador

Este repositorio demuestra una implementación de prueba de concepto de un servidor de Protocolo de contexto de modelo (MCP) que se ejecuta en Cloudflare Workers con autenticación de token de portador simple.

Descripción general

Este proyecto muestra cómo:

• Implementar un servidor MCP en la red perimetral de Cloudflare
• Implementar la autenticación básica del token de portador
• Cree y exponga herramientas MCP a través de una arquitectura sin servidor

Desarrollo local

Después de iniciar el servidor, estará disponible en http://localhost:8787

Autenticación

Esta implementación utiliza un esquema simple de autenticación de token de portador. Los clientes deben proporcionar un encabezado de autorización con sus solicitudes. El servidor envía este token a las herramientas MCP, lo que permite que estas realicen acciones según el usuario autenticado.

Pruebas con MCP Inspector

Puede utilizar el Inspector MCP para probar su servidor MCP:

1. Instalar e iniciar el inspector:
   npx @modelcontextprotocol/inspector
2. Configurar el inspector:
   • Cambiar el tipo de transporte a SSE
   • Ingrese la URL de su servidor MCP (local: http://localhost:8787/sse o implementado: https://your-worker.workers.dev/sse )
   • Agregue un token de portador en el campo Autorización
   • Haga clic en "Conectar"
3. Pruebe la funcionalidad:
   • Haga clic en "Lista de herramientas" para ver las herramientas disponibles
   • Intente ejecutar la herramienta "getToken", que le devolverá su encabezado de autorización
   • Pruebe la herramienta "agregar" con dos números para probar la funcionalidad básica

Implementación en Cloudflare

Implemente su servidor MCP en Cloudflare Workers:

Después de la implementación, su servidor estará disponible en https://your-worker.workers.dev

Estructura del proyecto

• src/index.ts - Implementación del servidor principal con definición de herramientas MCP
• src/utils.ts - Utilidades auxiliares para renderizar la interfaz web
• wrangler.jsonc : configuración de Cloudflare Workers

Notas importantes

Esta es una implementación de prueba de concepto que demuestra cómo MCP puede ejecutarse en un entorno sin servidor. En un entorno de producción, se recomienda implementar:

• Autenticación más robusta (OAuth, validación de tokens, etc.)
• Limitación de velocidad y medidas de seguridad adicionales
• Manejo y monitoreo adecuados de errores

Solución de problemas

Si encuentra problemas:

1. Asegúrese de que su token portador esté formateado correctamente en el encabezado de autorización
2. Consulte los registros de los trabajadores en el panel de Cloudflare
3. Intente reiniciar su servidor de desarrollo local

Para problemas de autenticación persistentes, es posible que deba borrar todas las credenciales almacenadas en caché: