Remote MCP Server on Cloudflare

What is Remote MCP Server on Cloudflare?

A remote MCP (Model Context Protocol) server that runs on Cloudflare Workers with OAuth login. It allows developers to deploy and host MCP tools remotely, enabling connections from 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 via npx nx dev remote-mcp-server, then connect using the MCP Inspector (set Transport Type to SSE and URL to http://localhost:8787/sse) or configure Claude Desktop with mcp-remote as the command and the same URL. For production, deploy to Cloudflare Workers by creating an OAUTH_KV namespace with npx wrangler kv namespace create OAUTH_KV and running npm run deploy.

Key features of Remote MCP Server on Cloudflare

• OAuth login for secure access
• Local development with hot-reload
• Deploy to Cloudflare Workers with one command
• SSE (Server-Sent Events) transport
• Works with MCP Inspector and Claude Desktop
• Debugging support via command-line testing

Use cases of Remote MCP Server on Cloudflare

• Hosting MCP tools on a scalable Cloudflare edge network
• Connecting Claude Desktop to custom MCP servers remotely
• Testing MCP tools locally before deploying
• Prototyping and demonstrating MCP-based applications

FAQ from Remote MCP Server on Cloudflare

How do I run the server locally?

Clone the repository, run npm install, then npx nx dev remote-mcp-server. Open http://localhost:8787/ in your browser to see the server.

How do I deploy the server to Cloudflare?

First create an OAUTH_KV namespace with npx wrangler kv namespace create OAUTH_KV, add the namespace ID to wrangler.jsonc, then run npm run deploy.

How do I connect Claude Desktop to the remote server?

Update Claude Desktop’s configuration file (Settings > Developer > Edit Config) with an entry using mcp-remote command and the remote URL (e.g., https://worker-name.account-name.workers.dev/sse), then restart Claude. A browser window will open for OAuth login.

What should I do if something goes wrong?

Restart Claude, try connecting directly via npx mcp-remote http://localhost:8787/sse, or clear the files in ~/.mcp-auth with rm -rf ~/.mcp-auth.

What are the prerequisites for using this server?

A Node.js environment, Cloudflare Workers access, and the ability to run npx commands. The server depends on Cloudflare KV for OAuth state and uses SSE for transport.