Workers MCP Demo

🚀 クラウドフレアワーカーMCPデモ

これは、Cloudflare Workers MCP を使用して、Claude、Cursor、およびその他のMCP対応AIアシスタントと連携可能なカスタムAIツールを作成する簡単なデモプロジェクトです。

🚀 クイックスタート

このデモプロジェクトでは、Cloudflare Workers MCPを利用してカスタムAIツールを作成し、AIアシスタントの能力を拡張します。以下に手順を説明します。

✨ 主な機能

• Cloudflare Workers上で動作するカスタムAIツール
• Claude、Cursor、その他のMCPクライアントとのシームレスな統合
• 独自のサーバーレス関数でAIの能力を拡張可能

📦 インストール

前提条件

• Node.js (v16以上)
• pnpm パッケージマネージャー
• Cloudflareアカウント
• Wrangler CLI
• Claude Desktop、Cursor、またはその他のMCP対応クライアント

セットアップ手順

1. このリポジトリをクローン

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

2. 依存関係をインストール

pnpm install

3. クラウドフレアワーカーを構成

Wranglerを使用してCloudflareにログインしてください。

pnpx wrangler login

次に、MCPセットアップコマンドを実行します。

npx workers-mcp setup

これにより、WorkerがMCPをサポートするように自動的に構成されます。

無料ユーザーの構成に関する注意事項

Cloudflare Workersの無料ユーザー（有料ユーザーではない）の場合、wrangler.jsonc ファイルを編集し、以下の構成を削除またはコメントアウトする必要があります。

"browser": {
  "binding": "BROWSER"
}

これは、Browser Rendering APIが有料ユーザーのみ利用可能なためです。この構成を削除すると、screenshotURL と extractImagesFromURL 機能は使用できなくなりますが、その他の機能は正常に動作します。

4. ワーカーをデプロイ

pnpm run deploy

5. MCPクライアントを構成

Claude Desktopの場合

以下のコマンドを実行して、ClaudeにMCPサーバーをインストールします。

pnpx workers-mcp install:claude

Cursorの場合

CursorのMCP構成に以下の内容を追加します。

{
  "type": "command",
  "command": "/path/to/workers-mcp run workers-mcp-demo https://your-worker-url.workers.dev /path/to/workers-mcp-demo"
}

💻 使用例

基本的な使用法

構成が完了したら、AIアシスタントから直接カスタムMCPツールを使用できます。例えば、Claude Desktopでは以下のコマンドを使用できます。

@workers-mcp-demo getRandomNumber

📚 ドキュメント

利用可能なツール

このデモには以下のツールが含まれています。

• getRandomNumber：乱数を生成します。
• generateImage：テキストプロンプトに基づいて画像を作成します。
• screenshotURL：指定されたURLのスクリーンショットを撮ります（有料アカウントが必要）。
• extractImagesFromURL：ウェブページから画像を抽出します（有料アカウントが必要）。

カスタマイズ

独自のツールを追加するには、src/index.ts ファイルを編集し、Workerクラスに新しいメソッドを追加します。変更を加えた後、以下のコマンドを使用してWorkerを再デプロイします。

pnpm run deploy

トラブルシューティング

• AIアシスタントがツールを認識しない場合は、アシスタントを再起動してみてください。
• メソッド名やパラメータを変更した場合は、変更を反映するためにAIアシスタントを再起動する必要があります。
• Cloudflare Workersのログを確認して、デプロイ中のエラーを確認してください。
• 無料アカウントを使用している場合に Error: Browser Rendering API is only available for Workers Paid plans エラーが発生した場合は、上記の無料ユーザーの構成に関する注意事項を参照してください。

📄 ライセンス

このプロジェクトは MITライセンス の下で提供されています。

謝辞

• Cloudflare Workers MCP は基盤となるフレームワークを提供しています。
• Anthropic Model Context Protocol はオープンソースのMCP標準を提供しています。
• Cloudflare Workers はサーバーレスプラットフォームを提供しています。