Overview
What is Remote MCP Server on Cloudflare?
A reference implementation for running a remote Model Context Protocol (MCP) server on Cloudflare Workers, complete with OAuth login. It is intended for developers who want to host MCP tools remotely and connect clients like Claude Desktop.
How to use Remote MCP Server on Cloudflare?
Clone the repository, install dependencies, and run locally with npx nx dev remote-mcp-server. Connect the MCP Inspector by switching transport type to SSE and entering http://localhost:8787/sse. For Claude Desktop, configure it to use the mcp-remote proxy pointing to the same SSE endpoint. Deploy to Cloudflare using npm run deploy after setting up a KV namespace.
Key features of Remote MCP Server on Cloudflare
- Runs on Cloudflare Workers with OAuth login
- Uses SSE (Server-Sent Events) transport
- Integrates with MCP Inspector for testing
- Connects to Claude Desktop via a local proxy
- Supports local development and remote deployment
Use cases of Remote MCP Server on Cloudflare
- Hosting custom MCP tools on the edge with Cloudflare
- Building and testing remote MCP servers locally before deploying
- Enabling Claude Desktop to invoke tools from a remote server
- Demonstrating OAuth-based authentication for MCP servers
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. Open http://localhost:8787/ in a browser.
How do I connect the MCP Inspector?
Start the inspector with npx @modelcontextprotocol/inspector, switch transport type to SSE, and enter http://localhost:8787/sse as the URL. You will be prompted to log in.
How do I connect Claude Desktop to my server?
Edit Claude Desktop’s config file to add an MCP server entry with command npx, args ["mcp-remote", "http://localhost:8787/sse"] (or the remote URL after deployment). Restart Claude.
How do I deploy to Cloudflare?
Create a KV namespace with npx wrangler kv namespace create OAUTH_KV, add its ID to wrangler.jsonc, then run npm run deploy.
How do I debug connection issues?
Try npx mcp-remote http://localhost:8787/sse directly. In rare cases, clear ~/.mcp-auth with rm -rf ~/.mcp-auth and restart Claude.
