Cloudflare MCP Server — Code Mode

Serverless-Starter zum Erstellen eines entfernten Model Context Protocol (MCP)-Servers auf Cloudflare Workers.

Das Projekt wurde für den Code-Modus konzipiert: Clients können Fähigkeiten entdecken und Werkzeugaufrufe aus strukturierten Antworten zusammensetzen. Beliebige Codeausführung ist im Starter nicht aktiviert; sie darf erst dann hinzugefügt werden, wenn Sandbox, Authentifizierung, Limits und Auditierung definiert wurden.

Ziel

• An der Edge über Cloudflare Workers ausführen.

• Einen MCP-Endpunkt unter /mcp bereitstellen.

• Werkzeuge klein, typisiert und komponierbar halten.

• OAuth-Authentifizierung und Cloudflare-Bindings vorbereiten.

• Zu sicherer Codeausführung in einer isolierten Sandbox weiterentwickeln.

Related MCP server: Adi MCP

Lokale Entwicklung

Voraussetzungen: Node.js 18+ und ein Cloudflare-Konto mit aktivierten Workers.

npm install
npm run dev

Der lokale Server ist unter http://localhost:8788/mcp erreichbar.

Zum Validieren mit dem MCP Inspector:

npx @modelcontextprotocol/inspector@latest

Konfiguration

npx wrangler login
npm run deploy

Nach dem Deployment wird der Endpunkt sein:

https://<worker>.<account>.workers.dev/mcp

Struktur

• src/index.ts: HTTP-Routing des Workers.

• src/mcp.ts: MCP-Server und Werkzeuge.

• wrangler.jsonc: Worker-Konfiguration.

• PLAN.md: Implementierungsplan und Abnahmekriterien.

Sicherheit

Fügen Sie kein eval, keine new Function und keinen Code-Interpreter direkt in den Worker ein. Für den Code-Modus mit realer Ausführung verwenden Sie eine geeignete Sandbox, starke Authentifizierung, API-Allowlists, CPU-/Speicher-/Zeitlimits, Isolierung pro Benutzer und Logs ohne Geheimnisse.

Nächste Schritte

Siehe PLAN.md.