hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Integrations

Allows connecting Claude Desktop to a Cloudflare Worker, enabling custom functions to be executed on Cloudflare's edge network. Supports capabilities like running Workers AI for image generation and utilizing Durable Objects for state management.
Enables image generation through Workers AI using the Flux model, allowing Claude to suggest prompts and interpret the generated images.

`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 構成がエラーの原因ではないことを確認したい場合は、再実行しても安全です。

他の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 耐久性のあるオブジェクト

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

Claude Desktop およびその他の MCP クライアントを Cloudflare Workers に接続し、モデルコンテキストプロトコルを通じて自然言語でカスタム機能にアクセスできるようにするパッケージ。

Related Resources

Reddit Discussion about this server

Appeared in Searches

How to connect to a React Native development build