Cloudflare Worker MCP

Cloudflare Worker MCP

Cloudflare Worker MCP est un ensemble d'outils qui vous permet d'exposer des fonctions de vos Cloudflare Workers en tant qu'outils MCP. Cela permet une intégration fluide entre vos Workers déployés et des clients d'agents IA comme Claude Desktop, Cursor, ou tout système compatible MCP. Il fournit des utilitaires en ligne de commande et une logique runtime pour connecter les Workers Cloudflare locaux ou distants à l'écosystème du Model Context Protocol, rendant vos fonctions de Worker programmables et accessibles aux agents LLM.

Author: cloudflare


Voir le Protocole

Qu'est-ce que Cloudflare Worker MCP ?

Cloudflare Worker MCP est un paquet qui vous permet de connecter vos Cloudflare Workers à des clients MCP comme Claude Desktop. Il traduit vos méthodes de Worker en TypeScript ou JavaScript en outils appelables via le Model Context Protocol. Les agents et les applications IA peuvent les utiliser pour exécuter des logiques, appeler des APIs et interagir avec des services sur la plateforme mondiale de Cloudflare.

Comment configurer

  1. Créez un nouveau Cloudflare Worker avec npx create-cloudflare@latest votre-nom-de-worker et naviguez dans le répertoire du projet.
  2. Installez le paquet workers-mcp : npm install workers-mcp
  3. Exécutez la commande de configuration : npx workers-mcp setup
  4. Déployez votre Worker après les modifications avec npm run deploy, ce qui garde à jour votre Worker et les métadonnées pour MCP.
  5. Si vous vous intégrez avec des clients comme Cursor ou des agents MCP personnalisés, configurez votre fichier .json ou votre configuration de projet pour pointer vers votre serveur avec une chaîne de commande/arguments combinée comme approprié.

Comment utiliser

  1. Créez et déployez votre Cloudflare Worker comme d'habitude. Exportez vos fonctions (comme les points de terminaison API ou la logique computationnelle) de votre Worker en utilisant des méthodes de classe standard.
  2. Une fois workers-mcp installé et initialisé, ces méthodes sont exposées comme des outils MCP, les rendant découvrables et appelables par des clients comme Claude Desktop.
  3. Exécutez un serveur proxy Node.js local (si nécessaire) avec workers-mcp run ..., qui se connecte à votre Worker déployé et enregistre vos fonctions pour les clients MCP.
  4. Utilisez les fonctionnalités MCP intégrées des clients compatibles pour lister, invoquer et interagir avec vos outils exposés par le Worker.

Caractéristiques clés

  • Exposez sans effort n'importe quelle fonction de Cloudflare Worker en tant qu'outil MCP, permettant des appels de procédure à distance par des agents IA.
  • Traduction automatique des signatures des méthodes de Worker (avec documentation) en interface d'outils MCP.
  • Mises à jour en temps réel : redéployez le code du Worker pour mettre à jour la logique des outils et les métadonnées sans configuration supplémentaire.
  • Support CLI pour la configuration, l'exécution d'un proxy local et l'intégration dans divers clients compatibles MCP.
  • Prend en charge la connectivité des Workers locaux et distants, avec une configuration sécurisée et personnalisable.

Cas d'utilisation

  • Fournir aux agents LLM des APIs sans serveur dynamiques, telles que la génération de nombres aléatoires, la récupération de données ou la logique d'application spécifique au domaine.
  • Activer des flux de travail automatisés où Claude ou d'autres agents IA invoquent des fonctions de Worker pour s'intégrer avec des APIs en aval ou des services cloud.
  • Construire des applications pilotées par des agents avec des effets dans le monde réel, comme la génération d'images, le traitement de données ou même le rendu de navigateur.
  • Prototypage rapide de nouvelles APIs ou fonctions qui sont instantanément accessibles aux outils de codage activés par IA.

FAQ

Q1 : Dois-je redéployer après des modifications de code ?
Oui, si vous modifiez le code de votre Worker, exécutez npm run deploy pour mettre à jour l'instance du Worker et ses métadonnées de fonction pour les outils MCP. Si vous changez les noms de fonction, les paramètres, ou ajoutez/enlevez des méthodes, vous devrez peut-être redémarrer le client MCP.

Q2 : Comment me connecter à mon Worker depuis différents clients ?
Vous pouvez utiliser la CLI avec la bonne commande ou configurer votre client compatible MCP (comme Cursor, Claude Desktop, ou des configurations personnalisées) en pointant vers votre serveur MCP dans le fichier de configuration. La commande est généralement /path/to/workers-mcp run <nom> <worker-url> <project-path>.

Q3 : Puis-je exposer n'importe quelle fonction ou API sur les Workers Cloudflare ?
Oui, vous pouvez exposer pratiquement n'importe quelle fonction, des aides simples aux intégrations avancées avec les services Cloudflare ou les APIs externes. Vos méthodes Worker deviennent automatiquement des outils MCP appelables.

Q4 : Comment résoudre les problèmes d'installation ?
Si la configuration échoue, exécutez npx workers-mcp help pour des commandes de diagnostic et vérifiez la sortie de la CLI pour des indications sur la configuration. Relancer npx workers-mcp install:claude est sans danger si vous soupçonnez un problème de configuration.