Overview
What is Remote MCP Server on Cloudflare?
Remote MCP Server on Cloudflare is a starter project for deploying a Model Context Protocol (MCP) server to Cloudflare Workers with OAuth login. It is intended for developers who want to run an MCP server remotely and connect to clients such as Claude Desktop.
How to use Remote MCP Server on Cloudflare?
Clone the repository, install dependencies, and run npx nx dev remote-mcp-server to start locally. Deploy using npm run deploy after creating a KV namespace for OAuth. Connect clients like the MCP Inspector or Claude Desktop using the SSE endpoint (e.g., http://localhost:8787/sse or a workers.dev URL) via the mcp-remote proxy.
Key features of Remote MCP Server on Cloudflare
- Run MCP server locally with
npx nx dev remote-mcp-server - Deploy to Cloudflare Workers with
npm run deploy - OAuth login implemented using Cloudflare KV
- Connect via SSE transport for remote access
- Works with MCP Inspector and Claude Desktop
Use cases of Remote MCP Server on Cloudflare
- Host a custom MCP server on Cloudflare’s global network
- Test MCP tools locally with the MCP Inspector
- Connect a remote MCP server to Claude Desktop
- Add OAuth-based authentication to an MCP server
FAQ from Remote MCP Server on Cloudflare
How do I connect to the server using the MCP Inspector?
In the inspector, switch Transport Type to SSE and enter the server’s SSE URL (e.g., http://localhost:8787/sse), then click “Connect”. You will be redirected to a login screen.
How do I connect Claude Desktop to my remote server?
Edit the Claude Desktop configuration file and add an entry with "command": "npx", "args": ["mcp-remote", "https://your-worker.workers.dev/sse"]. Restart Claude.
What are the runtime dependencies?
Node.js and npm are required for local development. Deploying requires a Cloudflare account and wrangler CLI. The mcp-remote package is used as a local proxy.
Where are OAuth tokens stored?
OAuth data is stored in a Cloudflare KV namespace named OAUTH_KV. You must create this namespace before deploying.
How can I debug connection issues?
Try restarting Claude or connecting directly using npx mcp-remote http://localhost:8787/sse. In rare cases, clearing ~/.mcp-auth with rm -rf ~/.mcp-auth may help.
