Claude DesktopのCloudflareワーカーに話してください!

[!警告] まずはここから始めて、リモートのMCPサーバーを構築するべきです

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

workers-mcpとは何ですか?

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

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

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

使用法

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

create-cloudflareを使って新しいワーカーを生成してください。

workers-mcp

Talk to a Cloudflare Worker from Claude Desktop!

[!WARNING]
You should start here instead — and build a remote MCP server

You can connect to remote MCP servers from Claude Desktop, Cursor, and other clients using mcp-remote.

What is workers-mcp?

This package provides both the CLI tooling and the in-Worker logic to connect Claude Desktop (or any MCP Client) to a Cloudflare Worker on your account, so you can customise it to suit your needs. It works via a build step that can translate TypeScript methods of your Worker like this:

export class ExampleWorkerMCP extends WorkerEntrypoint {
  /**
   * 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
}

…into MCP tools that a local Node.js server can expose to MCP clients. The Node.js server acts as a proxy, handling stdio transport locally, and calling the relevant method of your Worker running on Cloudflare. This allows you to expose any function or API in your app, or any service in Cloudflare’s developer platform, back to a LLM in your coding agent, Claude Desktop or other MCP client.

Yes, I know that Math.random() works the same on a Worker as it does on your local machine, but don’t tell Claude 🤫

Usage

Step 1: Generate a new Worker

Use create-cloudflare to generate a new Worker.

npx create-cloudflare@latest my-new-worker

I suggest choosing a Hello World worker.

Step 2: Install workers-mcp

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

Step 3: Run the setup command

npx workers-mcp setup

Note: if something goes wrong, run npx workers-mcp help

Step 4…♾️: Iterating

After changing your Worker code, you only need to run npm run deploy to update both Claude’s metadata about your function and your live Worker instance.

However, if you change the names of your methods, or their parameters, or add or remove methods, Claude will not see the updates until you restart it.

You shouldn’t ever need to rerun npx workers-mcp install:claude, but it’s safe to do so if you want to rule out Claude config as a source of errors.

Using with Other MCP Clients

Cursor