Déploiement rapide des services MCP dans les travailleurs de Cloudflare

Dernières ressources sur l'IAMise à jour il y a 6 mois Cercle de partage de l'IA

14.5K 00

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.tomlAjoutez 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.tsen MyWorker 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 mouvement pnpm buildL'outil génère une liste de tous les fichiers JSDoc qui peuvent être utilisés dans le JSDoc. dist/docs.jsonqui contient des informations sur la description et les paramètres de tous les outils.
fonction de test
exécuter localement wrangler devSi 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 Desktop claude_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
existent wrangler.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 commande setValue 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 !