hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Integrations

Allows connecting Claude Desktop to a Cloudflare Worker, enabling custom functions to be executed on Cloudflare's edge network. Supports capabilities like running Workers AI for image generation and utilizing Durable Objects for state management.
Enables image generation through Workers AI using the Flux model, allowing Claude to suggest prompts and interpret the generated images.

`workers-mcp`

¡Hable con un trabajador de Cloudflare desde Claude Desktop!

[!ADVERTENCIA]
Deberías comenzar aquí y crear un servidor MCP remoto
Puede conectarse a servidores MCP remotos desde Claude Desktop, Cursor y otros clientes usando mcp-remote .

¿Qué es `workers-mcp` ?

Este paquete proporciona las herramientas de la CLI y la lógica interna del Worker para conectar Claude Desktop (o cualquier cliente MCP ) a un Worker de Cloudflare en su cuenta, para que pueda personalizarlo según sus necesidades. Funciona mediante un paso de compilación que traduce los métodos TypeScript de su Worker de la siguiente manera:

export class ExampleWorkerMCP extends WorkerEntrypoint<Env> {
  /**
   * Generates a random number. This is extra random because it had to travel all the way to
   * your nearest Cloudflare PoP to be calculated which... something something lava lamps?
   *
   * @return {string} A message containing a super duper random number
   * */
  async getRandomNumber() {
    return `Your random number is ${Math.random()}`
  }
  
  // ...etc
}

...en herramientas MCP que un servidor Node.js local puede exponer a clientes MCP. El servidor Node.js actúa como proxy, gestionando localmente el transporte de stdio y llamando al método correspondiente de su Worker que se ejecuta en Cloudflare. Esto le permite exponer cualquier función o API de su aplicación, o cualquier servicio en la plataforma de desarrollo de Cloudflare , a un LLM en su agente de codificación, Claude Desktop u otro cliente MCP.

Sí, sé que Math.random() funciona igual en un Worker que en tu máquina local, pero no se lo digas a Claude 🤫

Uso

Paso 1: Generar un nuevo trabajador

Utilice create-cloudflare para generar un nuevo trabajador.

npx create-cloudflare@latest my-new-worker

Sugiero elegir un trabajador Hello World .

Paso 2: Instalar `workers-mcp`

cd my-new-worker # I always forget this bit
npm install workers-mcp

Paso 3: Ejecute el comando `setup`

npx workers-mcp setup

Nota: si algo sale mal, ejecute npx workers-mcp help

Paso 4..♾️: Iteración

Después de cambiar el código de Worker, solo necesita ejecutar npm run deploy para actualizar los metadatos de Claude sobre su función y su instancia de Worker en vivo.

Sin embargo, si cambia los nombres de sus métodos o sus parámetros, o agrega o elimina métodos, Claude no verá las actualizaciones hasta que lo reinicie.

Nunca debería ser necesario volver a ejecutar npx workers-mcp install:claude , pero es seguro hacerlo si desea descartar la configuración de Claude como una fuente de errores.

Uso con otros clientes MCP

Cursor

Para que su servidor Cloudflare MCP funcione en Cursor, debe combinar "command" y "args" de su archivo de configuración en una sola cadena y usar el tipo "command".

Por ejemplo, si su archivo de configuración se ve así:

{
  "mcpServers": {
    "your-mcp-server-name": {
      "command": "/path/to/workers-mcp",
      "args": [
        "run",
        "your-mcp-server-name",
        "https://your-server-url.workers.dev",
        "/path/to/your/project"
      ],
      "env": {}
    }
  }
}

En Cursor, cree una entrada de servidor MCP con:

tipo: command
comando: /path/to/workers-mcp run your-mcp-server-name https://your-server-url.workers.dev /path/to/your/project

Otros clientes de MCP

Para Windsurf y otros clientes MCP, actualice su archivo de configuración para incluir su trabajador para que pueda usar las herramientas directamente desde el cliente:

{
  "mcpServers": {
    "your-mcp-server-name": {
      "command": "/path/to/workers-mcp",
      "args": [
        "run",
        "your-mcp-server-name",
        "https://your-server-url.workers.dev",
        "/path/to/your/project"
      ],
      "env": {}
    }
  }
}

Asegúrese de reemplazar los marcadores de posición con el nombre del servidor, la URL y la ruta del proyecto reales.

Ejemplos

Consulte el directorio de examples para obtener algunas ideas sobre cómo utilizar esto:

examples/01-hello-world es una instantánea tomada después de las instrucciones de instalación anteriores
examples/02-image-generation utiliza Workers AI para ejecutar el modelo de generación de imágenes Flux. Claude es muy bueno sugiriendo indicaciones y puede interpretar el resultado y decidir qué nuevas indicaciones probar para lograr el resultado deseado.
TODO Renderizado del navegador
TODO Objetos duraderos

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

Un paquete que conecta Claude Desktop y otros clientes MCP con Cloudflare Workers, lo que permite acceder a funcionalidades personalizadas a través del lenguaje natural mediante el Protocolo de contexto de modelo.

Related Resources

Reddit Discussion about this server

Appeared in Searches

How to connect to a React Native development build