Remote MCP Server on Cloudflare
@Safeturf
Overview
What is Remote MCP Server on Cloudflare?
It is a setup for running a remote MCP server on Cloudflare Workers with OAuth login, enabling developers to host and connect MCP tools via SSE transport.
How to use Remote MCP Server on Cloudflare?
Clone the repository, install dependencies with pnpm install, and run locally with npx nx dev remote-mcp-server. Deploy to Cloudflare by creating a KV namespace via npx wrangler kv namespace create OAUTH_KV, adding its ID to wrangler.jsonc, then running npm run deploy. Connect clients (MCP Inspector or Claude Desktop) using the SSE endpoint (/sse).
Key features of Remote MCP Server on Cloudflare
- Runs on Cloudflare Workers with OAuth login
- Supports SSE transport for MCP connections
- Local development with hot‑reload via nx
- Deployment to a workers.dev domain
- Integration with Claude Desktop via remote proxy
Use cases of Remote MCP Server on Cloudflare
- Hosting MCP tools on a serverless platform
- Connecting Claude Desktop to remote tools with OAuth
- Testing MCP tools locally using the MCP Inspector
- Deploying a math tool for remote use
FAQ from Remote MCP Server on Cloudflare
How do I debug connection issues?
Restart Claude, or try connecting directly with npx mcp-remote http://localhost:8787/sse. In rare cases, clear the files in ~/.mcp-auth with rm -rf ~/.mcp-auth.
How do I connect Claude Desktop to the remote server?
Update the Claude configuration file (mcpServers) to use npx mcp-remote with the workers.dev URL (e.g., https://worker-name.account-name.workers.dev/sse).
How do I deploy to Cloudflare?
Run npx wrangler kv namespace create OAUTH_KV, add the returned KV namespace ID to wrangler.jsonc, then run npm run deploy.
How do I run the server locally?
Clone the repo, run pnpm install, then npx nx dev remote-mcp-server. Open http://localhost:8787/ in your browser.
