Despliegue rápido de servicios MCP en Cloudflare Workers

Introducción general

Trabajadores de Cloudflare MCP es un proyecto de código abierto desarrollado por Cloudflare y alojado en GitHub, diseñado para ayudar a los desarrolladores a crear e implementar rápidamente servidores MCP (Model Context Protocol) basados en Cloudflare Workers. Esta herramienta combina las potentes capacidades de computación en la nube de Cloudflare Workers con el protocolo MCP, permitiendo a los usuarios crear herramientas personalizadas a través de sencillas funciones TypeScript e integrarlas en clientes habilitados para MCP como Antrópico (utilizado como expresión nominal) Claude Desktop). Es especialmente adecuado para desarrolladores que desean utilizar la infraestructura de Cloudflare para lograr funciones de servidor eficientes y ligeras, compatibles con servicios como R2, D1, KV, etc. El proceso de implementación es sencillo y la experiencia de desarrollo es fluida, lo que goza de gran popularidad entre la comunidad técnica.

Lista de funciones

• Configuración rápida del servidor MCPCreación e implementación rápidas de servidores MCP en Cloudflare Workers a través de la herramienta CLI.
• Soporte para el desarrollo de TypeScriptEscribir funciones en TypeScript y generar descripciones de herramientas utilizando anotaciones JSDoc.
• Integración de los servicios de CloudflareSoporta R2 (almacén de objetos), D1 (base de datos), KV (almacén clave-valor) y otras llamadas a funciones.
• Conectividad sin fisuras con clientes MCPInterfaces con clientes MCP como Claude Desktop para la personalización.
• Generación automática de documentosGeneración automática de documentación amigable con LLM a partir de comentarios JSDoc en el código.
• Proceso de implantación eficazImplementación con un solo clic en la red global de Cloudflare junto con la CLI de Wrangler.
• Apoyo al desarrollo localProporcionar un entorno de prueba local para la depuración y la iteración.

Utilizar la ayuda

Proceso de instalación

Para utilizar Cloudflare Workers MCP, es necesario preparar un entorno básico, a continuación, siga los siguientes pasos para instalar y configurar el proyecto. Todo el proceso es sencillo y adecuado para usuarios con experiencia básica en desarrollo.

1. Preparación medioambiental

• Node.jsAsegúrese de que tiene Node.js instalado en su ordenador (versión >= 16.17.0), lo que puede hacerse con el comando node -v Comprueba la versión.
• Wrangler CLIEsta es la herramienta de línea de comandos oficial de Cloudflare Workers para desplegar y gestionar proyectos Worker. Método de instalación:

  npm install -g wrangler

Tras la instalación, ejecute wrangler login Inicie sesión en su cuenta de Cloudflare.

• Claude Desktop (opcional)Si desea integrar el servidor MCP con Claude Desktop, debe descargar e instalar la aplicación Claude Desktop (sitio web oficial: https://claude.ai/download).
• GitPara clonar un proyecto desde GitHub, ejecute git --version Compruebe si está instalado.

2. Clonación de proyectos

Abra un terminal e introduzca el siguiente comando para clonar el repositorio MCP de Cloudflare Workers:

git clone https://github.com/cloudflare/workers-mcp.git
cd workers-mcp

3. Instalación de dependencias

Una vez en el directorio del proyecto, instale los paquetes de dependencias necesarios. Puedes elegir entre npm o pnpm:

npm install

tal vez

pnpm install

Una vez finalizada la instalación, el proyecto contendrá todas las librerías necesarias, tales como @modelcontextprotocol/sdk responder cantando tsx.

4. Configuración de Wrangler

Asegúrese de que su wrangler.toml El archivo contiene información de la cuenta de Cloudflare. Ejecute el siguiente comando para iniciar sesión y generar el archivo de configuración:

wrangler login

Una vez iniciada la sesión, edite wrangler.tomlAñade tu account_id(disponible en el panel de control de Cloudflare):

account_id = "你的账户ID"

5. Operaciones locales

Pruebe el servidor MCP localmente, en ejecución:

pnpm build
npx workers-mcp secret generate

Esto genera una clave y la almacena en el .dev.vars archivo. A continuación, inicie el entorno de desarrollo local:

wrangler dev

La URL local del indicador de acceso (normalmente http://localhost:8787), compruebe que el servidor funciona correctamente.

6. Despliegue en Cloudflare

Después de comprobar si hay errores, despliegue en Cloudflare Workers utilizando el siguiente comando:

pnpm deploy:worker

Tras una implementación correcta, obtendrá una URL para Cloudflare Worker (p. ej. https://your-worker.workers.dev), es la dirección de su servidor MCP.

Función Flujo de operaciones

Características principales: Creación rápida de servidores MCP

1. Escribir funciones TypeScript
   espectáculo (una entrada) src/index.tsen MyWorker para añadir funciones personalizadas. Ejemplo:

   /**
   * 返回一个友好的问候语。
   * @param name {string} 用户的名字
   * @return {string} 问候语内容
   */
   sayHello(name: string) {
   return `你好，${name}！来自 MCP Worker 的问候！`;
   }
   

   Las anotaciones JSDoc generan automáticamente descripciones de las herramientas.

2. Generar documentación
   estar en movimiento pnpm buildLa herramienta genera una lista de todos los archivos JSDoc que pueden utilizarse en el JSDoc. dist/docs.jsonque contiene información sobre la descripción y los parámetros de todas las herramientas.
3. función de prueba
   ejecutar localmente wrangler devSi quieres probarlo, puedes hacerlo utilizando un navegador o curl test:

   curl http://localhost:8787
   

   Como alternativa, configure la dirección del servidor MCP directamente en Claude Desktop llamando a la función sayHello Herramientas.

Función: integración con Claude Desktop

1. Configuración de Claude Desktop
   Abra el archivo de configuración de Claude Desktop claude_desktop_config.json(normalmente situado en el directorio de usuario), añada el servidor MCP:

   {
   "mcpServers": {
   "my-worker": {
   "command": "npx",
   "args": ["workers-mcp", "proxy", "https://your-worker.workers.dev"]
   }
   }
   }
   

   Guarde y reinicie Claude Desktop.

2. herramienta de invocación
   En Claude Desktop, escriba algo como "Por favor, llame a la utilidad sayHello para saludar a John" y verá el resultado devuelto: "¡Hola John! Saludos de MCP Worker".

Función: Integración con los servicios de Cloudflare

1. Uso del almacenamiento KV
   existe wrangler.toml Añade un enlace KV al

   [[kv_namespaces]]
   binding = "MY_KV"
   id = "你的 KV ID"
   

   Manipular KV en código:

   async setValue(key: string, value: string) {
   await this.env.MY_KV.put(key, value);
   return `已存储 ${key}: ${value}`;
   }
   

2. Despliegue y pruebas
   Tras la redistribución, llame a la función setValue para verificar que los datos se depositan en el KV.

advertencia

• Gestión de claves: Ejecutar npx workers-mcp secret upload Sube tus claves a Cloudflare para garantizar la seguridad.
• Consejos de depuración: Uso wrangler dev --remote Conectable a los enlaces del entorno de producción para facilitar la depuración.
• Funciones ampliadas: Se pueden introducir servicios adicionales de Cloudflare (por ejemplo, R2, D1) simplemente añadiendo lo siguiente al archivo wrangler.toml Configure la vinculación en el

Con estos pasos, puede empezar rápidamente con Cloudflare Workers MCP y crear un potente servidor MCP.