Remote MCP Server on Cloudflare

What is Remote MCP Server on Cloudflare?

A reference implementation for deploying a remote MCP server on Cloudflare Workers with OAuth login. It shows developers how to build, run locally, and deploy an MCP server that remote clients (like Claude Desktop) can connect to over SSE.

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. For deployment, create a KV namespace and run npm run deploy. Connect MCP clients (Inspector or Claude Desktop) by pointing them to the SSE endpoint at /sse.

Key features of Remote MCP Server on Cloudflare

• Deploy a remote MCP server on Cloudflare Workers
• OAuth‑based login flow for MCP clients
• SSE transport for remote tool invocation
• Local development with the MCP Inspector
• Single‑command deployment via wrangler

Use cases of Remote MCP Server on Cloudflare

• Running an MCP server hosted on Cloudflare and accessed remotely
• Connecting Claude Desktop to a remotely hosted MCP server
• Testing and debugging MCP tools with the MCP Inspector
• Prototyping a production‑grade remote MCP deployment

FAQ from Remote MCP Server on Cloudflare

How do I develop locally?

Clone the repo, run npm install, then npx nx dev remote-mcp-server. The server will be available 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”. A mock login screen appears; input any email and password.

How do I connect Claude Desktop to my local server?

Add the following to Claude’s mcpServers config: "command": "npx", "args": ["mcp-remote", "http://localhost:8787/sse"]. Restart Claude; a browser window will open for login.

How do I deploy to Cloudflare?

Run 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.

How do I connect a remote MCP client after deployment?

Use the MCP Inspector or Claude Desktop with the URL https://your-worker.your-account.workers.dev/sse. For Claude, set "args": ["mcp-remote", "https://your-worker.your-account.workers.dev/sse"].