Remote MCP Server on Cloudflare

What is Remote MCP Server on Cloudflare?

A reference implementation that gets a remote MCP server running on Cloudflare Workers with OAuth login. It is intended for developers who want to build and deploy MCP servers accessible over the internet.

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. Deploy using npx wrangler kv namespace create OAUTH_KV, update wrangler.jsonc with the KV namespace ID, and run npm run deploy. Connect clients (MCP Inspector, Claude Desktop) via SSE at the server’s /sse endpoint.

Key features of Remote MCP Server on Cloudflare

• Runs on Cloudflare Workers for global deployment
• OAuth login flow integrated into the server
• Communicates via SSE (Server-Sent Events) transport
• Supports local development with hot-reload
• Works with MCP Inspector and Claude Desktop

Use cases of Remote MCP Server on Cloudflare

• Deploy an MCP server publicly without managing infrastructure
• Test and debug MCP tools locally before deploying
• Connect Claude Desktop to a remote MCP server for AI tool use
• Build a template for your own cloud‑hosted MCP server

FAQ from Remote MCP Server on Cloudflare

What runtime does this server require?

Node.js and npm are needed for local development; a Cloudflare account is required for deployment.

How is authentication handled?

The server uses an OAuth login flow. During local development a mock login screen appears; after deployment, the real OAuth flow is used.

What transport protocol does the server use?

The server uses SSE (Server‑Sent Events) over HTTP. Clients connect to the server’s /sse endpoint.

How do I connect Claude Desktop to the server?

Update Claude’s configuration file to use npx mcp-remote with the server’s URL (e.g., https://worker-name.account-name.workers.dev/sse). Claude will open a browser window for OAuth login.

Where does authentication data live?

The README mentions that clearing ~/.mcp-auth can help during debugging, indicating OAuth tokens are stored locally in that directory.