Remote MCP Server on Cloudflare

What is Remote MCP Server on Cloudflare?

A template for running a remote MCP (Model Context Protocol) server on Cloudflare Workers with OAuth login. It allows developers to quickly deploy and test MCP tools that can be accessed by remote clients like Claude Desktop or the MCP Inspector.

How to use Remote MCP Server on Cloudflare?

Clone the repository, install dependencies with npm install, run locally with npx nx dev remote-mcp-server, or deploy to Cloudflare Workers using npm run deploy after setting up a KV namespace. Connect remote MCP clients (e.g., MCP Inspector, Claude Desktop) by pointing them to the server's SSE endpoint (e.g., http://localhost:8787/sse locally or the Worker's workers.dev URL).

Key features of Remote MCP Server on Cloudflare

• Runs as a Cloudflare Worker with OAuth authentication
• Supports SSE (Server-Sent Events) transport for MCP
• Easy local development with hot‑reload
• One‑command deployment to Cloudflare Workers
• Works with standard MCP clients (Inspector, Claude Desktop)
• Built‑in KV namespace for OAuth token storage

Use cases of Remote MCP Server on Cloudflare

• Developing and testing custom MCP tools locally
• Connecting Claude Desktop to a remote MCP server over the internet
• Demonstrating MCP integrations without managing your own server infrastructure
• Quick prototyping of MCP‑enabled AI workflows

FAQ from Remote MCP Server on Cloudflare

How do I debug connection issues?

Run npx mcp-remote http://localhost:8787/sse on the command line to test connectivity. In rare cases, clear the files in ~/.mcp-auth with rm -rf ~/.mcp-auth and restart Claude.

How do I connect Claude Desktop to a remote MCP server?

In Claude Desktop, go to Settings > Developer > Edit Config and add an entry using npx mcp-remote with the server’s SSE URL (e.g., https://worker-name.account-name.workers.dev/sse). Restart Claude.

What transport protocol does this MCP server use?

The server uses Server‑Sent Events (SSE) as its transport protocol. Remote clients connect to the /sse endpoint.

What dependencies do I need to run or deploy?

Locally you need Node.js and npm. For deployment you need a Cloudflare account, the Wrangler CLI (npx wrangler), and a Cloudflare KV namespace named OAUTH_KV.

How do I deploy to Cloudflare Workers?

First run npx wrangler kv namespace create OAUTH_KV and add the returned namespace ID to wrangler.jsonc. Then run npm run deploy. The server will be accessible at a workers.dev URL.