Remote MCP Server on Cloudflare

What is Remote MCP Server on Cloudflare?

A project that helps you set up a remote MCP (Model Context Protocol) server on Cloudflare Workers with OAuth login. It is intended for developers who want to host MCP tools remotely and connect them to MCP clients like Claude Desktop.

How to use Remote MCP Server on Cloudflare?

Clone the repository, install dependencies with npm install, then run locally with npx nx dev remote-mcp-server. Use the MCP Inspector (npx @modelcontextprotocol/inspector) with SSE transport at http://localhost:8787/sse to test tools. Deploy with npm run deploy after creating a KV namespace (npx wrangler kv namespace create OAUTH_KV) and adding the namespace ID to wrangler.jsonc. Connect Claude Desktop by adding a mcp-remote entry pointing to your workers.dev URL.

Key features of Remote MCP Server on Cloudflare

• OAuth login for secure access to tools
• Runs on Cloudflare Workers for global scalability
• Communicates via SSE (Server-Sent Events)
• Compatible with MCP Inspector and Claude Desktop
• Local development with hot reload support
• Simple deployment with Wrangler CLI

Use cases of Remote MCP Server on Cloudflare

• Hosting MCP tools that require remote access
• Connecting Claude Desktop to a server running on Cloudflare
• Testing MCP endpoints locally with the official Inspector
• Deploying a scalable, authenticated MCP server for team use

FAQ from Remote MCP Server on Cloudflare

What transport does this server use?

The server uses SSE (Server-Sent Events) as the transport protocol.

How do I connect Claude Desktop to the remote server?

Update your Claude Desktop configuration file (claude_desktop_config.json) with an entry that uses npx mcp-remote and the workers.dev URL (e.g., https://worker-name.account-name.workers.dev/sse).

How can I debug connection issues?

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

What are the runtime dependencies?

You need Node.js, npm, and a Cloudflare account. Locally, you also need npx and Wrangler CLI for deployment. The server uses a Cloudflare Workers KV namespace for OAuth state.

How does authentication work?

During local development, a mock login screen is presented (any email and password work). In production, OAuth login is handled via the browser when connecting through the MCP Inspector or Claude Desktop.