Remote MCP Server on Cloudflare

What is Remote MCP Server on Cloudflare?

Remote MCP Server on Cloudflare is a starter project to run a remote MCP (Model Context Protocol) server on Cloudflare Workers with OAuth login. It is intended for developers who want to deploy an MCP server that can be accessed remotely and integrated with clients like Claude Desktop.

How to use Remote MCP Server on Cloudflare?

Clone the repository, install dependencies with npm install, and run locally with npx nx dev remote-mcp-server. To deploy, create a KV namespace with npx wrangler kv namespace create OAUTH_KV, add its ID to wrangler.jsonc, then run npm run deploy. Connect clients (MCP Inspector or Claude Desktop) via SSE at the /sse endpoint.

Key features of Remote MCP Server on Cloudflare

• Run on Cloudflare Workers with OAuth login
• Develop locally with hot reload
• Connect via MCP Inspector or Claude Desktop
• Uses SSE (Server-Sent Events) transport
• Simple deployment using Wrangler CLI

Use cases of Remote MCP Server on Cloudflare

• Deploy a remote MCP server accessible over the internet
• Prototype and test MCP tools locally before deploying
• Integrate MCP tools with Claude Desktop through a remote endpoint
• Build and iterate on MCP servers with Cloudflare’s infrastructure

FAQ from Remote MCP Server on Cloudflare

How do I run the server locally?

Clone the repo, run npm install, then npx nx dev remote-mcp-server. Access it at http://localhost:8787/.

How do I connect the MCP Inspector to my local server?

Start the inspector with npx @modelcontextprotocol/inspector, set Transport Type to SSE, enter http://localhost:8787/sse, and click Connect. You’ll be presented with a mock login screen.

How do I connect Claude Desktop to the remote server?

Update Claude’s config file to add an MCP server entry with command: "npx", args: ["mcp-remote", "https://your-worker.your-account.workers.dev/sse"]. Claude will open a browser for OAuth login.

How do I deploy the server to Cloudflare?

Create a KV namespace with npx wrangler kv namespace create OAUTH_KV, add the namespace ID to wrangler.jsonc, then run npm run deploy. Your server will be available at a workers.dev URL.

What debugging steps are recommended?

Restart Claude, or test connectivity directly using npx mcp-remote http://localhost:8787/sse. In rare cases, clear cached auth files with rm -rf ~/.mcp-auth.