概览
What is Remote MCP Server on Cloudflare?
Remote MCP Server on Cloudflare is an MCP server that runs on Cloudflare Workers with OAuth login. It enables MCP clients—such as Claude Desktop or the MCP Inspector—to connect remotely via SSE and call defined tools.
How to use Remote MCP Server on Cloudflare?
Clone the repository, install dependencies, and run locally with npx nx dev remote-mcp-server. For production, deploy to Cloudflare using npm run deploy after configuring a KV namespace. Connect clients by pointing them to your worker’s workers.dev URL with the /sse endpoint.
Key features of Remote MCP Server on Cloudflare
- Runs on Cloudflare Workers.
- OAuth login for secure access.
- SSE transport for MCP clients.
- Remote deployment with Wrangler.
- Local development with mock OAuth.
- Supports MCP Inspector for testing.
Use cases of Remote MCP Server on Cloudflare
- Connect Claude Desktop to a custom MCP server hosted on Cloudflare.
- Test and debug MCP tools using the MCP Inspector.
- Deploy a production MCP server without managing infrastructure.
- Prototype MCP tools locally before deploying.
- Enable authenticated remote access to MCP tools.
FAQ from Remote MCP Server on Cloudflare
How do I test the server locally?
Run npx nx dev remote-mcp-server and open http://localhost:8787/ in a browser. Use the MCP Inspector with SSE and the local URL to test tools.
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 connect Claude Desktop to the server?
Update Claude’s config file to point to the server’s URL with /sse (e.g., https://worker-name.account-name.workers.dev/sse), using npx mcp-remote as the command.
What transport does the MCP server use?
It uses SSE (Server-Sent Events) as the transport protocol for MCP clients.
How can I debug connection issues?
Try connecting directly via npx mcp-remote http://localhost:8787/sse or clear cached auth files with rm -rf ~/.mcp-auth. Restarting Claude may also help.
