Schnelle Bereitstellung von MCP-Diensten in Cloudflare Workers

🚀 Einladung zum Erleben: Chinas erste KI-IDE Intelligente Programmiersoftware Trae Chinesische Version downloadDer DeepSeek-R1 und Doubao-pro sind unbegrenzt verfügbar!

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.

Schnelles Erstellen von MCP-Server-Tools für Cloudflare Workers-1

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

Ablauf der Installation

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 mit dem Befehl Knoten -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-Anmeldung Melden Sie sich bei Ihrem Cloudflare-Konto an.

Claude Desktop (optional)Wenn Sie den MCP-Server mit 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-Installation

vielleicht

pnpm-Installation

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 Zänker.toml Die Datei enthält Cloudflare-Kontoinformationen. Führen Sie den folgenden Befehl aus, um sich anzumelden und die Konfigurationsdatei zu erstellen:

Wrangler-Anmeldung

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

account_id = "Ihre Konto-ID"

5. lokale Operationen

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

pnpm bauen
npx workers-mcp geheim erzeugen

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

Wrangler-Entwickler

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

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

/**
* Gibt eine freundliche Begrüßung zurück.
* @param name {string} Der Name des Benutzers.
* @return {string} Der Inhalt der Begrüßung.
*/
sayHello(name: string) {
return `Hallo, ${Name}! Grüße von MCP Worker! `;
}

JSDoc-Anmerkungen erzeugen automatisch Werkzeugbeschreibungen.

Dokumentation generieren
in Bewegung sein pnpm bauenDas 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.
Testfunktion
lokal laufen Wrangler-EntwicklerWenn Sie es testen wollen, können Sie dies mit einem Browser oder einem Curl-Test tun:
```
http://localhost:8787 locken.
```
Alternativ können Sie die MCP-Serveradresse auch direkt in Claude Desktop konfigurieren, indem Sie die Funktion sayHello Werkzeuge.

Merkmal: Integration mit Claude Desktop

Claude Desktop konfigurieren
Öffnen Sie die Konfigurationsdatei von Claude Desktop claude_desktop_config.json(normalerweise im Benutzerverzeichnis), fügen Sie den MCP-Server hinzu:
```
{
"mcpServer": {
"my-worker": {
"Befehl": "npx".
"args": ["workers-mcp", "proxy", "https://your-worker.workers.dev"]
}
}
}
```
Speichern Sie und starten Sie Claude Desktop neu.
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

KV-Speicher verwenden
existieren Zänker.toml Fügen Sie eine KV-Bindung zum

[[kv_namespaces]]
binding = "MY_KV"
id = "Ihre KV-ID"

Manipulieren Sie KV im Code:

async setValue(key: string, value: string) {
await this.env.MY_KV.put(schlüssel, wert);
return `Gespeicherte ${Schlüssel}: ${Wert}`;
}

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, um das Debugging zu erleichtern.
Erweiterte FunktionalitätZusätzliche Cloudflare-Dienste (z. B. R2, D1) können einfach durch Hinzufügen der folgenden Zeilen in die Datei Zänker.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!