# workers-mcp

> MCP Client

The `workers-mcp` repository provides tools to connect Claude Desktop or other MCP clients to a Cloudflare Worker, enabling custom functionalities and access to Cloudflare's services from within the LLM coding agent.

## Overview

- **Category:** Developer Tools
- **Language:** TypeScript
- **Stars:** 644
- **Forks:** 37
- **Owner:** cloudflare
- **GitHub:** https://github.com/cloudflare/workers-mcp
- **Homepage:** https://www.npmjs.com/package/workers-mcp
- **Created:** 2024-12-17T22:26:38+00:00
- **Updated:** 2025-03-28T21:27:44+00:00
- **Source:** https://model-context-protocol.com/clients/cloudflare-worker-claude-desktop-integration

## Setup

## Setup

1.  Generate a new Worker using `create-cloudflare`. `npx create-cloudflare@latest my-new-worker`
2.  Choose a `Hello World` worker.
3.  Install `workers-mcp`: `cd my-new-worker` then `npm install workers-mcp`
4.  Run the `setup` command: `npx workers-mcp setup`
5.  Iterate by changing Worker code and running `npm run deploy` to update Claude's metadata and the live Worker instance.
6.  Restart Claude after changing method names, parameters, or adding/removing methods.
7.  Rerun `npx workers-mcp install:claude` if needed to rule out Claude config errors.

## Tools

## Available Tools

1.  **CLI tooling and in-Worker logic** (Connects Claude Desktop or any MCP Client to a Cloudflare Worker).
2.  **TypeScript method translation** (Translates TypeScript methods of your Worker into MCP tools).
3.  **Node.js server proxy** (Handles stdio transport locally and calls the relevant method of your Worker).
4.  **Integration with Cloudflare's developer platform** (Exposes any function or API in your app or any service in Cloudflare's developer platform).
5.  **Examples directory** (Provides examples like hello-world and image-generation using Workers AI).