workers-mcp

Claude Desktop の Cloudflare ワーカーにご相談ください。

[！警告]
代わりにここから始め、リモートMCPサーバーを構築してください。

mcp-remote を使用して、 Claude Desktop、Cursor、およびその他のクライアントからリモート MCP サーバーに接続できます。

workers-mcpとは何ですか?

このパッケージは、Claude Desktop（または任意のMCPクライアント）をアカウント上のCloudflare Workerに接続するためのCLIツールとWorker内ロジックの両方を提供するため、ニーズに合わせてカスタマイズできます。このパッケージは、WorkerのTypeScriptメソッドを次のように変換できるビルドステップを介して動作します。

export class ExampleWorkerMCP extends WorkerEntrypoint<Env> {
  /**
   * Generates a random number. This is extra random because it had to travel all the way to
   * your nearest Cloudflare PoP to be calculated which... something something lava lamps?
   *
   * @return {string} A message containing a super duper random number
   * */
  async getRandomNumber() {
    return `Your random number is ${Math.random()}`
  }
  
  // ...etc
}

ローカルNode.jsサーバーがMCPクライアントに公開できるMCPツールに変換します。Node.jsサーバーはプロキシとして機能し、stdioトランスポートをローカルで処理し、Cloudflare上で実行されているWorkerの関連メソッドを呼び出します。これにより、アプリ内の任意の関数やAPI、あるいはCloudflare開発者プラットフォーム内の任意のサービスを、コーディングエージェント、Claude Desktop、またはその他のMCPクライアントのLLMに公開できます。

はい、 Math.random()が Worker でもローカルマシンと同じように動作することはわかっていますが、Claude には言わないでください 🤫

使用法

ステップ1: 新しいワーカーを生成する

create-cloudflareを使用して新しい Worker を生成します。

npx create-cloudflare@latest my-new-worker

Hello Worldワーカーを選択することをお勧めします。

ステップ2: workers-mcpをインストールする

cd my-new-worker # I always forget this bit
npm install workers-mcp

ステップ3: setupコマンドを実行する

npx workers-mcp setup

注: 何か問題が発生した場合は、 npx workers-mcp helpを実行してください。

ステップ4..♾️: 反復

Worker コードを変更した後は、 npm run deployを実行して、関数に関する Claude のメタデータとライブ Worker インスタンスの両方を更新するだけです。

ただし、メソッドの名前やパラメータを変更したり、メソッドを追加または削除したりした場合は、Claude を再起動するまで更新は表示されません。

npx workers-mcp install:claudeを再実行する必要はありませんが、Claude 構成がエラーの原因ではないことを確認したい場合は、再実行しても安全です。

Related MCP server: Remote MCP Server

他のMCPクライアントとの使用

カーソル

Cloudflare MCP サーバーを Cursor で動作させるには、構成ファイルの「command」と「args」を 1 つの文字列に結合し、「command」タイプを使用する必要があります。

たとえば、設定ファイルは次のようになります。

{
  "mcpServers": {
    "your-mcp-server-name": {
      "command": "/path/to/workers-mcp",
      "args": [
        "run",
        "your-mcp-server-name",
        "https://your-server-url.workers.dev",
        "/path/to/your/project"
      ],
      "env": {}
    }
  }
}

カーソルで、次の MCP サーバー エントリを作成します。

• タイプ: command

• コマンド: /path/to/workers-mcp run your-mcp-server-name https://your-server-url.workers.dev /path/to/your/project

その他のMCPクライアント

Windsurf やその他の MCP クライアントの場合は、クライアントから直接ツールを使用できるように、構成ファイルを更新してワーカーを含めます。

{
  "mcpServers": {
    "your-mcp-server-name": {
      "command": "/path/to/workers-mcp",
      "args": [
        "run",
        "your-mcp-server-name",
        "https://your-server-url.workers.dev",
        "/path/to/your/project"
      ],
      "env": {}
    }
  }
}

プレースホルダーを実際のサーバー名、URL、プロジェクト パスに置き換えてください。

例

これを何に使用するかについてのアイデアをいくつか確認するには、 examplesディレクトリを参照してください。

• examples/01-hello-world上記のインストール手順の後に作成されたスナップショットです。

• examples/02-image-generation Workers AI を使用して Flux 画像生成モデルを実行します。Claude はプロンプトの提案が非常に得意で、結果を解釈し、望ましい結果を達成するためにどのような新しいプロンプトを試みるべきかを決定します。

• TODO ブラウザレンダリング

• TODO 耐久性のあるオブジェクト