Remote MCP Server on Cloudflare
@KenNguyen-34
Overview
What is Remote MCP Server on Cloudflare?
Remote MCP Server on Cloudflare is a reference implementation for running an MCP (Model Context Protocol) server on Cloudflare Workers with OAuth login. It enables developers to expose MCP tools over HTTP/SSE and connect them to remote clients such as Claude Desktop.
How to use Remote MCP Server on Cloudflare?
Clone the repository, install dependencies with npm install, then run locally with npx nx dev remote-mcp-server. For deployment, create a KV namespace with npx wrangler kv namespace create OAUTH_KV, add its ID to wrangler.jsonc, and run npm run deploy. Connect clients via SSE by pointing them to http://localhost:8787/sse (local) or https://worker-name.account-name.workers.dev/sse (deployed). Use the MCP Inspector or mcp-remote proxy to interact with the server.
Key features of Remote MCP Server on Cloudflare
- Deploys on Cloudflare Workers with minimal configuration
- Supports SSE transport for remote MCP connections
- Includes OAuth login (mock for local development)
- Compatible with MCP Inspector and Claude Desktop
- Uses Cloudflare KV for persistent authentication state
Use cases of Remote MCP Server on Cloudflare
- Run MCP tools on a globally distributed serverless platform
- Connect Claude Desktop to a remote MCP server over the internet
- Develop and test MCP servers locally before deployment
- Integrate OAuth-based authentication into MCP workflows
FAQ from Remote MCP Server on Cloudflare
What are the prerequisites to run Remote MCP Server on Cloudflare?
Node.js and npm are required for local development. Deployment requires a Cloudflare account and the Wrangler CLI.
How do I connect the MCP Inspector to my server?
Start the Inspector with npx @modelcontextprotocol/inspector, set Transport Type to SSE, and enter http://localhost:8787/sse (local) or the workers.dev URL as the server URL. A mock login screen will appear.
How do I connect Claude Desktop to the remote server?
Add an entry to Claude Desktop’s config file with "command": "npx" and "args": ["mcp-remote", "http://localhost:8787/sse"] for local or "https://worker-name.account-name.workers.dev/sse" for remote. Restart Claude and a browser login window will open.
How can I debug connection issues?
Run npx mcp-remote http://localhost:8787/sse directly on the command line. If needed, clear cached authorization files with rm -rf ~/.mcp-auth.
Does the server store any data? Where?
Yes, authentication state is stored in a Cloudflare KV namespace named OAUTH_KV, which you create during setup.
