Remote MCP Server on Cloudflare

What is Remote MCP Server on Cloudflare?

A template to quickly run a remote MCP (Model Context Protocol) server on Cloudflare Workers with OAuth login. It's for developers who want to build and deploy their own MCP server to the Cloudflare edge and connect it to MCP clients like Claude Desktop.

How to use Remote MCP Server on Cloudflare?

Clone the repository, install dependencies (npm install), and run locally with npx nx dev remote-mcp-server. Deploy by creating a KV namespace (npx wrangler kv namespace create OAUTH_KV) and running npm run deploy. Connect via the MCP Inspector by using SSE transport with the server URL (e.g., http://localhost:8787/sse locally, or your workers.dev URL). For Claude Desktop, configure mcpServers in its config file to run npx mcp-remote pointing to the same SSE endpoint.

Key features of Remote MCP Server on Cloudflare

• OAuth login integrated (local mock)
• Deployable to Cloudflare Workers edge network
• Local development with hot reload
• Works with MCP Inspector for testing
• Compatible with Claude Desktop via remote proxy
• SSE transport for remote client connections

Use cases of Remote MCP Server on Cloudflare

• Running an MCP server on Cloudflare’s global network
• Building and testing custom MCP tools locally
• Connecting Claude Desktop to a remote MCP server
• Prototyping OAuth-secured MCP server interactions

FAQ from Remote MCP Server on Cloudflare

What does this server do?

It runs a remote MCP server on Cloudflare Workers that supports OAuth login and exposes tools (like a math example) over Server-Sent Events (SSE).

How do I deploy it to Cloudflare?

Create a KV namespace with npx wrangler kv namespace create OAUTH_KV, add its ID to wrangler.jsonc, then run npm run deploy. Your server will be available at https://<worker-name>.<account-name>.workers.dev/sse.

How do I connect Claude Desktop to my remote server?

In Claude Desktop’s config file, add an entry with command: "npx", args: ["mcp-remote", "https://<worker-name>.<account-name>.workers.dev/sse"]. Restart Claude – a browser login should appear.

How do I debug connection issues?

Try running npx mcp-remote http://localhost:8787/sse from the command line. If issues persist, clear authentication files with rm -rf ~/.mcp-auth and restart Claude.

What are the runtime dependencies?

The server requires Node.js and npm for local development, and the Cloudflare Wrangler CLI for deployment. It uses a KV namespace for OAuth state.