Cloudflare Worker MCP

Cloudflare Worker MCP

Cloudflare Worker MCP es un conjunto de herramientas que te permite exponer funciones de tus Cloudflare Workers como herramientas MCP. Esto permite una integración fluida entre tus Workers desplegados y clientes de agentes de IA como Claude Desktop, Cursor o cualquier sistema compatible con MCP. Proporciona utilidades de línea de comandos y lógica en tiempo de ejecución para conectar Workers de Cloudflare locales o remotos con el ecosistema del Protocolo de Contexto del Modelo, haciendo que las funciones de tu Worker sean programables y accesibles para agentes LLM.

Author: cloudflare


Ver Protocolo

¿Qué es Cloudflare Worker MCP?

Cloudflare Worker MCP es un paquete que te permite conectar tus Cloudflare Workers a clientes MCP como Claude Desktop. Traduce tus métodos de Worker en TypeScript o JavaScript en herramientas llamables a través del Protocolo de Contexto del Modelo, que los agentes y aplicaciones de IA pueden usar para ejecutar lógica, llamar a APIs e interactuar con servicios que se ejecutan en la plataforma global de Cloudflare.

Cómo configurar

  1. Genera un nuevo Cloudflare Worker usando npx create-cloudflare@latest tu-nombre-de-worker y navega al directorio del proyecto.
  2. Instala el paquete workers-mcp: npm install workers-mcp
  3. Ejecuta el comando de configuración: npx workers-mcp setup
  4. Despliega tu Worker después de los cambios usando npm run deploy, lo que mantiene tanto tu Worker como los metadatos para MCP actualizados.
  5. Si integras con clientes como Cursor o agentes MCP personalizados, configura tu archivo .json o la configuración del proyecto para apuntar a tu servidor usando una cadena de comando/args combinada según sea necesario.

Cómo usar

  1. Crea y despliega tu Cloudflare Worker como de costumbre. Exporta tus funciones (como endpoints de API o lógica computacional) desde tu Worker utilizando métodos de clase estándar.
  2. Con workers-mcp instalado e inicializado, estos métodos se exponen como herramientas MCP, haciéndolos descubribles y llamables por clientes como Claude Desktop.
  3. Ejecuta un servidor proxy local de Node.js (si es necesario) con workers-mcp run ..., que se conecta a tu Worker desplegado y registra tus funciones para clientes MCP.
  4. Usa las características MCP integradas de los clientes compatibles para listar, invocar e interactuar con tus herramientas expuestas por Worker.

Características clave

  • Expón de manera fluida cualquier función de Cloudflare Worker como una herramienta MCP, permitiendo llamadas de procedimiento remoto desde agentes habilitados para IA.
  • Traducción automática de las firmas de métodos de Worker (con documentación) a la interfaz de herramientas de MCP.
  • Actualizaciones en tiempo real: redeploy el código del Worker para actualizar la lógica de la herramienta y los metadatos sin configuración adicional.
  • Soporte CLI para configuración, ejecución de un proxy local e integración en varios clientes compatibles con MCP.
  • Soporta conectividad tanto local como remota de Workers, con una configuración segura y configurable.

Casos de uso

  • Proporcionar a los agentes LLM APIs serverless dinámicas, como generación de aleatoriedad, obtención de datos o lógica de aplicaciones específicas de dominio.
  • Habilitar flujos de trabajo automatizados donde Claude u otros agentes de IA invocan funciones de Worker para integrarse con APIs o servicios en la nube.
  • Construir aplicaciones impulsadas por agentes con efectos en el mundo real, como generación de imágenes, procesamiento de datos o incluso renderizado en navegadores.
  • Prototipado rápido de nuevas APIs o funciones que son instantáneamente accesibles para herramientas de codificación habilitadas para IA.

Preguntas frecuentes

Q1: ¿Necesito redeplegar después de cambios en el código?
Sí, si modificas el código de tu Worker, ejecuta npm run deploy para actualizar la instancia del Worker y sus metadatos de función para las herramientas MCP. Si cambias nombres de funciones, parámetros o agregas/eliminan métodos, es posible que debas reiniciar el cliente MCP.

Q2: ¿Cómo me conecto a mi Worker desde diferentes clientes?
Puedes usar la CLI con el comando correcto o configurar tu cliente compatible con MCP (como Cursor, Claude Desktop o configuraciones personalizadas) apuntando a la entrada de tu servidor MCP en el archivo de configuración. El comando es típicamente /path/to/workers-mcp run <nombre> <worker-url> <project-path>.

Q3: ¿Puedo exponer cualquier función o API en Cloudflare Workers?
Sí, puedes exponer prácticamente cualquier función, desde ayudantes simples hasta integraciones avanzadas con servicios de Cloudflare o APIs externas. Los métodos de tu Worker se convierten automáticamente en herramientas MCP llamables.

Q4: ¿Cómo soluciono problemas de instalación?
Si la configuración falla, ejecuta npx workers-mcp help para comandos de diagnóstico y revisa la salida de la CLI para obtener sugerencias de configuración. Volver a ejecutar npx workers-mcp install:claude es seguro si sospechas un problema de configuración.