Déploiement rapide des services MCP dans les travailleurs de Cloudflare
Introduction générale
Travailleurs de Cloudflare MCP est un projet open source développé par Cloudflare et hébergé sur GitHub pour aider les développeurs à construire et déployer rapidement des serveurs MCP (Model Context Protocol) basés sur Cloudflare Workers. Cet outil combine les puissantes capacités de cloud computing de Cloudflare Workers avec le protocole MCP, permettant aux utilisateurs de créer des outils personnalisés par le biais de simples fonctions TypeScript et de les intégrer dans des clients compatibles MCP tels que Anthropique (utilisé comme expression nominale) Claude Desktop). Il convient particulièrement aux développeurs qui souhaitent utiliser l'infrastructure Cloudflare pour obtenir des fonctions de serveur efficaces et légères, prenant en charge des services tels que R2, D1, KV, etc. Le processus de déploiement est simple et l'expérience de développement est fluide, ce qui est très populaire au sein de la communauté technique.

Liste des fonctions
- Configuration rapide du serveur MCPLes serveurs MCP peuvent être rapidement créés et déployés sur les Cloudflare Workers via l'outil CLI.
- Support au développement TypeScript: Écrire des fonctions en TypeScript et générer des descriptions d'outils à l'aide d'annotations JSDoc.
- Intégrer les services CloudflareLa fonction de gestion de la base de données : prend en charge R2 (magasin d'objets), D1 (base de données), KV (magasin de clés et de valeurs) et d'autres appels de fonction.
- Connectivité transparente avec les clients MCPInterfaces avec les clients MCP tels que Claude Desktop pour la personnalisation.
- Génération automatique de documentsLes outils d'aide à la décision : Générer automatiquement une documentation d'outil conviviale pour LLM à partir des commentaires JSDoc dans le code.
- Processus de déploiement efficaceDéploiement en un clic sur le réseau mondial de Cloudflare grâce à l'interface de commande Wrangler.
- Soutien au développement localLes services d'assistance technique : Fournir un environnement d'essai local pour le débogage et l'itération.
Utiliser l'aide
Processus d'installation
Pour utiliser Cloudflare Workers MCP, vous devez préparer un environnement de base, puis suivre les étapes ci-dessous pour installer et configurer le projet. L'ensemble du processus est simple et convient aux utilisateurs ayant une expérience de base en matière de développement.
1. préparation à l'environnement
- Node.jsPour cela, vous devez vous assurer que Node.js est installé sur votre ordinateur (version >= 16.17.0), ce qui peut être fait avec la commande
node -v
Vérifier la version. - CLI WranglerIl s'agit de l'outil de ligne de commande officiel pour Cloudflare Workers, qui permet de déployer et de gérer les projets Worker. Méthode d'installation :
npm install -g wrangler
Après l'installation, exécutez wrangler login
Connectez-vous à votre compte Cloudflare.
- Bureau Claude (optionnel)Si vous souhaitez intégrer le serveur MCP avec Claude Desktop, vous devez télécharger et installer l'application Claude Desktop (site officiel : https://claude.ai/download).
- GitPour cloner un projet à partir de GitHub, lancez
git --version
Vérifier s'il est installé.
2. clonage de projets
Ouvrez un terminal et entrez la commande suivante pour cloner le dépôt Cloudflare Workers MCP :
git clone https://github.com/cloudflare/workers-mcp.git
cd workers-mcp
3. installation des dépendances
Une fois dans le répertoire du projet, installez les paquets de dépendances nécessaires. Vous pouvez choisir npm ou pnpm :
npm install
peut-être
pnpm install
Une fois l'installation terminée, le projet contiendra toutes les bibliothèques nécessaires telles que @modelcontextprotocol/sdk
répondre en chantant tsx
.
4. configuration de Wrangler
Assurez-vous que votre wrangler.toml
Le fichier contient les informations relatives au compte Cloudflare. Exécutez la commande suivante pour vous connecter et générer le fichier de configuration :
wrangler login
Après avoir réussi à se connecter, modifiez wrangler.toml
Ajoutez votre account_id
(disponible dans le tableau de bord Cloudflare) :
account_id = "你的账户ID"
5. les opérations locales
Tester le serveur MCP localement, en cours d'exécution :
pnpm build
npx workers-mcp secret generate
Cette opération génère une clé et la stocke dans le fichier .dev.vars
fichier. Démarrez ensuite l'environnement de développement local :
wrangler dev
L'URL locale de l'invite d'accès (généralement http://localhost:8787
), vérifiez que le serveur fonctionne correctement.
6. déploiement sur Cloudflare
Après avoir vérifié qu'il n'y a pas d'erreurs, déployez le système sur les Cloudflare Workers à l'aide de la commande suivante :
pnpm deploy:worker
Après un déploiement réussi, vous obtiendrez une URL pour Cloudflare Worker (par ex. https://your-worker.workers.dev
), il s'agit de l'adresse de votre serveur MCP.
Fonction Opération Déroulement
Caractéristiques principales : Création rapide de serveurs MCP
- Écrire des fonctions TypeScript
spectacle (un billet)src/index.ts
enMyWorker
pour ajouter des fonctions personnalisées. Exemple :/** * 返回一个友好的问候语。 * @param name {string} 用户的名字 * @return {string} 问候语内容 */ sayHello(name: string) { return `你好,${name}!来自 MCP Worker 的问候!`; }
Les annotations JSDoc génèrent automatiquement des descriptions d'outils.
- Générer de la documentation
être en mouvementpnpm build
L'outil génère une liste de tous les fichiers JSDoc qui peuvent être utilisés dans le JSDoc.dist/docs.json
qui contient des informations sur la description et les paramètres de tous les outils. - fonction de test
exécuter localementwrangler dev
Si vous souhaitez le tester, vous pouvez le faire en utilisant un navigateur ou un test curl :curl http://localhost:8787
Vous pouvez également configurer l'adresse du serveur MCP directement dans Claude Desktop en appelant la commande
sayHello
Outils.
Fonctionnalité : Intégration avec Claude Desktop
- Configuration de Claude Desktop
Ouvrir le fichier de configuration de Claude Desktopclaude_desktop_config.json
(généralement situé dans le répertoire des utilisateurs), ajoutez le serveur MCP :{ "mcpServers": { "my-worker": { "command": "npx", "args": ["workers-mcp", "proxy", "https://your-worker.workers.dev"] } } }
Sauvegardez et redémarrez Claude Desktop.
- outil d'invocation
Dans Claude Desktop, tapez quelque chose comme "Please call the sayHello utility to greet John" et vous verrez le résultat : "Hello John ! Salutations de MCP Worker !".
Fonctionnalité : Intégration avec les services Cloudflare
- Utilisation du stockage KV
existentwrangler.toml
Ajouter une liaison KV à la[[kv_namespaces]] binding = "MY_KV" id = "你的 KV ID"
Manipuler KV dans le code :
async setValue(key: string, value: string) { await this.env.MY_KV.put(key, value); return `已存储 ${key}: ${value}`; }
- Déploiement et essais
Après le redéploiement, appelez la commandesetValue
pour vérifier que les données sont déposées dans la KV.
mise en garde
- Gestion des clés: Run
npx workers-mcp secret upload
Téléchargez vos clés sur Cloudflare pour garantir la sécurité. - Conseils de débogage: Utilisation
wrangler dev --remote
Connectable aux liens de l'environnement de production pour faciliter le débogage. - Fonctionnalité étendueLes services Cloudflare supplémentaires (par exemple, R2, D1) peuvent être introduits simplement en ajoutant ce qui suit à l'élément de menu
wrangler.toml
Configurer la liaison dans le
Avec ces étapes, vous pouvez rapidement démarrer avec Cloudflare Workers MCP et construire un serveur MCP puissant !
© déclaration de droits d'auteur
L'article est protégé par le droit d'auteur et ne doit pas être reproduit sans autorisation.
Articles connexes
Pas de commentaires...