Cloudflare MCP Server — Code Mode

Cloudflare Workers 上でリモートの Model Context Protocol (MCP) サーバーを構築するためのサーバーレススターターです。

このプロジェクトは code mode 向けに設計されています。クライアントは機能を発見し、構造化されたレスポンスを使ってツール呼び出しを組み立てることができます。スタータでは任意のコードの実行は有効化されていません。サンドボックス、認証、制限、監査を定義した後にのみ追加する必要があります。

目標

• Cloudflare Workers を介してエッジで実行する。

• /mcp で MCP エンドポイントを公開する。

• ツールを小さく、型付けされ、組み合わせ可能な状態に保つ。

• OAuth 認証と Cloudflare バインディングを準備する。

• 分離されたサンドボックスでの安全なコード実行へと進化させる。

Related MCP server: Adi MCP

ローカル開発

前提条件: Node.js 18+ と、Workers が有効な Cloudflare アカウント。

npm install
npm run dev

ローカルサーバーは http://localhost:8788/mcp で利用できます。

MCP Inspector で検証するには:

npx @modelcontextprotocol/inspector@latest

デプロイ

npx wrangler login
npm run deploy

デプロイ後、エンドポイントは次のようになります:

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

構造

• src/index.ts: Worker の HTTP ルーティング。

• src/mcp.ts: MCP サーバーとツール。

• wrangler.jsonc: Worker の設定。

• PLAN.md: 実装計画と受け入れ基準。

セキュリティ

eval、new Function、またはコードインタープリターを Worker 内に直接追加しないでください。実際の実行を伴う code mode を実装するには、適切なサンドボックス、強力な認証、API の許可リスト、CPU/メモリ/時間の制限、ユーザーごとの分離、そしてシークレットを含まないログを使用してください。

次のステップ

PLAN.md を参照してください。