Workers Mcp

What is Workers Mcp?

Workers Mcp is a package that connects Claude Desktop (or any MCP Client) to a Cloudflare Worker on your account. It provides both CLI tooling and in‑Worker logic to expose Worker RPC methods as MCP tools.

How to use Workers Mcp?

Install with npm install workers-mcp, then run npx workers-mcp help for instructions. Create a Worker with a WorkerEntrypoint that exports RPC methods documented with JSDoc. Add workers-mcp docgen src/index.ts to your deploy script, add a fetch handler that proxies events to your entrypoint using ProxyToSelf, generate a shared secret with workers-mcp secret generate, deploy with npm run deploy, and finally run workers-mcp install <alias> <url> to add the Worker to Claude Desktop.

Key features of Workers Mcp

• Connects Claude Desktop to Cloudflare Workers
• Exposes Worker RPC methods as MCP tools
• Uses simple shared‑key authentication
• Generates tool documentation from JSDoc
• Automates secret generation and deployment
• Supports iterative development with redeploy

Use cases of Workers Mcp

• Build custom Cloudflare Worker tools that Claude can invoke
• Deploy and interact with Worker functions via natural language
• Rapidly prototype and iterate on Worker endpoints with AI assistance
• Extend Claude’s capabilities with your own serverless logic

FAQ from Workers Mcp

How do I install Workers Mcp?

Install it via npm: npm install workers-mcp.

How do I set up authentication?

Use npx workers-mcp secret generate to generate a shared secret, then npx workers-mcp secret upload to add it to your deployed Worker. The fetch handler uses SHARED_SECRET for authentication.

How do I redeploy after changing my Worker code?

Run npm run deploy (which runs workers-mcp docgen and wrangler deploy). If you change method names, parameters, or add/remove methods, Claude will only see the updates after a restart.

What transport does Workers Mcp use?

Currently only ProxySelf is provided, which requires the Worker to be available on a public URL. ProxyToServiceBinding and ProxyToDurableObject are planned.

Can I use an existing Worker?

Yes, as long as you route your fetch calls appropriately and define a WorkerEntrypoint with RPC methods.