Remote MCP Server on Cloudflare

What is Remote MCP Server on Cloudflare?

A project for running a remote MCP (Model Context Protocol) server on Cloudflare Workers, complete with OAuth login. It is intended for developers who want to deploy a remote MCP server and connect it to clients like Claude Desktop.

How to use Remote MCP Server on Cloudflare?

Clone the repository, install dependencies with npm install, and run locally using npx nx dev remote-mcp-server. Deploy to Cloudflare by creating a KV namespace via npx wrangler kv namespace create OAUTH_KV, adding the ID to wrangler.jsonc, then running npm run deploy. Connect clients via the /sse endpoint.

Key features of Remote MCP Server on Cloudflare

• Runs on Cloudflare Workers with OAuth login
• Local development with MCP Inspector for testing
• Deploy to Cloudflare with KV namespace for auth
• Connect Claude Desktop via remote proxy
• SSE transport for MCP client communication

Use cases of Remote MCP Server on Cloudflare

• Deploy MCP tools without managing own infrastructure
• Expose MCP servers over the internet for remote clients
• Test and debug MCP tools locally before production deployment
• Integrate custom MCP tools with Claude Desktop

FAQ from Remote MCP Server on Cloudflare

How do I run the server locally?

Clone the repo, install dependencies, then run npx nx dev remote-mcp-server and open http://localhost:8787/ in a browser.

How do I deploy to Cloudflare?

Create a KV namespace with npx wrangler kv namespace create OAUTH_KV, add the namespace ID to wrangler.jsonc, and run npm run deploy.

How do I connect Claude Desktop to the remote server?

Update the Claude config to use npx mcp-remote with the workers.dev URL (e.g., https://worker-name.account-name.workers.dev/sse).

What authentication is used?

The server uses OAuth login, with a mock login screen for local development.

How can I debug connection issues?

Restart Claude, test directly with npx mcp-remote http://localhost:8787/sse, or clear the auth files in ~/.mcp-auth.