Schnelle Bereitstellung von MCP-Diensten in Cloudflare Workers

Allgemeine Einführung

Cloudflare-Arbeiter MCP ist ein von Cloudflare entwickeltes und auf GitHub gehostetes Open-Source-Projekt, das Entwicklern helfen soll, schnell MCP (Model Context Protocol)-Server auf Basis von Cloudflare Workers zu erstellen und einzusetzen. Dieses Tool kombiniert die leistungsstarken Cloud-Computing-Fähigkeiten von Cloudflare Workers mit dem MCP-Protokoll und ermöglicht es Benutzern, benutzerdefinierte Tools durch einfache TypeScript-Funktionen zu erstellen und sie in MCP-fähige Clients zu integrieren, wie z. B. Anthropisch (in Form eines Nominalausdrucks) Claude Desktop). Es ist besonders für Entwickler geeignet, die die Cloudflare-Infrastruktur nutzen möchten, um effiziente, leichtgewichtige Serverfunktionen zu erreichen, die Dienste wie R2, D1, KV usw. unterstützen. Der Bereitstellungsprozess ist einfach und die Entwicklung verläuft reibungslos, was in der technischen Gemeinschaft sehr beliebt ist.

Funktionsliste

• MCP-Server-SchnelleinrichtungSchnelles Erzeugen und Bereitstellen von MCP-Servern für Cloudflare Workers über das CLI-Tool.
• Unterstützung der TypeScript-EntwicklungWrite function functions in TypeScript and generate tool descriptions using JSDoc annotations.
• Integration von Cloudflare-DienstenUnterstützt R2 (Objektspeicher), D1 (Datenbank), KV (Key-Value-Store) und andere Funktionsaufrufe.
• Nahtlose Konnektivität mit MCP-ClientsSchnittstellen mit MCP-Clients wie Claude Desktop zur Anpassung.
• Automatische DokumentenerstellungAutomatisch LLM-freundliche Werkzeugdokumentation aus JSDoc-Kommentaren im Code generieren.
• Effizienter EinsatzprozessEin-Klick-Bereitstellung im globalen Netzwerk von Cloudflare in Verbindung mit dem Wrangler CLI.
• Unterstützung der lokalen EntwicklungBereitstellung einer lokalen Testumgebung für Debugging und Iteration.

Hilfe verwenden

Einbauverfahren

Um Cloudflare Workers MCP zu verwenden, müssen Sie eine grundlegende Umgebung vorbereiten und dann die folgenden Schritte zur Installation und Konfiguration des Projekts ausführen. Der gesamte Prozess ist unkompliziert und für Benutzer mit grundlegenden Entwicklungserfahrungen geeignet.

1. die Vorbereitung der Umwelt

• Node.jsNode.js: Stellen Sie sicher, dass Sie Node.js auf Ihrem Computer installiert haben (Version >= 16.17.0), was Sie mit dem Befehl node -v Überprüfen Sie die Version.
• Wrangler CLIDies ist das offizielle Kommandozeilen-Tool für Cloudflare Workers, um Worker-Projekte bereitzustellen und zu verwalten. Installationsmethode:

  npm install -g wrangler

Nach der Installation führen Sie wrangler login Melden Sie sich bei Ihrem Cloudflare-Konto an.

• Claude Desktop (optional)Wenn Sie den MCP-Server in Claude Desktop integrieren möchten, müssen Sie die Anwendung Claude Desktop herunterladen und installieren (offizielle Website: https://claude.ai/download).
• GitUm ein Projekt von GitHub zu klonen, führen Sie git --version Prüfen Sie, ob sie installiert ist.

2. klonen von Projekten

Öffnen Sie ein Terminal und geben Sie den folgenden Befehl ein, um das Cloudflare Workers MCP-Repository zu klonen:

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

3. die Installation von Abhängigkeiten

Sobald Sie sich im Projektverzeichnis befinden, installieren Sie die erforderlichen Abhängigkeitspakete. Sie können entweder npm oder pnpm wählen:

npm install

vielleicht

pnpm install

Nach Abschluss der Installation enthält das Projekt alle erforderlichen Bibliotheken, wie z. B. @modelcontextprotocol/sdk im Gesang antworten tsx.

4. die Konfiguration des Wrangler

Stellen Sie sicher, dass Ihr wrangler.toml Die Datei enthält Cloudflare-Kontoinformationen. Führen Sie den folgenden Befehl aus, um sich anzumelden und die Konfigurationsdatei zu erstellen:

wrangler login

Nach erfolgreicher Anmeldung, bearbeiten Sie wrangler.tomlFügen Sie Ihr account_id(verfügbar im Cloudflare Dashboard):

account_id = "你的账户ID"

5. lokale Operationen

Testen Sie den MCP-Server lokal, indem Sie ihn ausführen:

pnpm build
npx workers-mcp secret generate

Dieser generiert einen Schlüssel und speichert ihn in der .dev.vars Datei. Starten Sie dann die lokale Entwicklungsumgebung:

wrangler dev

Die lokale URL der Eingabeaufforderung (normalerweise http://localhost:8787), überprüfen Sie, ob der Server ordnungsgemäß funktioniert.

6. die Bereitstellung bei Cloudflare

Nachdem Sie auf Fehler geprüft haben, stellen Sie Cloudflare Workers mit dem folgenden Befehl bereit:

pnpm deploy:worker

Nach erfolgreichem Einsatz erhalten Sie eine URL für Cloudflare Worker (z. B. https://your-worker.workers.dev), ist dies die Adresse Ihres MCP-Servers.

Funktion Betriebsablauf

Hauptmerkmale: Rascher Aufbau von MCP-Servern

1. TypeScript-Funktionen schreiben
   zeigen (eine Eintrittskarte) src/index.tsin MyWorker Klasse, um eigene Funktionen hinzuzufügen. Beispiel:

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

   JSDoc-Anmerkungen erzeugen automatisch Werkzeugbeschreibungen.

2. Dokumentation generieren
   in Bewegung sein pnpm buildDas Tool erstellt eine Liste aller JSDoc-Dateien, die in der JSDoc verwendet werden können. dist/docs.jsondie Informationen über die Beschreibung und die Parameter aller Werkzeuge enthält.
3. Testfunktion
   lokal laufen wrangler devWenn Sie es testen wollen, können Sie dies mit einem Browser oder einem Curl-Test tun:

   curl http://localhost:8787
   

   Alternativ können Sie die MCP-Serveradresse auch direkt in Claude Desktop konfigurieren, indem Sie die Funktion sayHello Werkzeuge.

Merkmal: Integration mit Claude Desktop

1. Claude Desktop konfigurieren
   Öffnen Sie die Konfigurationsdatei von Claude Desktop claude_desktop_config.json(normalerweise im Benutzerverzeichnis), fügen Sie den MCP-Server hinzu:

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

   Speichern Sie und starten Sie Claude Desktop neu.

2. Aufrufwerkzeug
   Geben Sie in Claude Desktop etwas ein wie "Bitte rufen Sie das Dienstprogramm sayHello auf, um John zu begrüßen", und Sie werden das Ergebnis sehen: "Hallo John! Grüße von MCP Worker!".

Funktion: Integration mit Cloudflare-Diensten

1. KV-Speicher verwenden
   existieren wrangler.toml Fügen Sie eine KV-Bindung zum

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

   Manipulieren Sie KV im Code:

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

2. Einsatz und Prüfung
   Rufen Sie nach der Neuverteilung die setValue um zu prüfen, ob die Daten in der KV hinterlegt sind.

caveat

• Schlüsselverwaltung: Lauf npx workers-mcp secret upload Laden Sie Ihre Schlüssel zu Cloudflare hoch, um die Sicherheit zu gewährleisten.
• Tipps zur Fehlersuche: Verwendung wrangler dev --remote Verbindet sich mit der Produktionsumgebung und ermöglicht so ein einfaches Debugging.
• Erweiterte FunktionalitätZusätzliche Cloudflare-Dienste (z. B. R2, D1) können einfach durch Hinzufügen der folgenden Zeilen in die Datei wrangler.toml Konfigurieren Sie die Bindung in der

Mit diesen Schritten können Sie schnell mit Cloudflare Workers MCP beginnen und einen leistungsstarken MCP-Server aufbauen!