概览
What is Remote MCP Server on Cloudflare?
It is a remote MCP (Model Context Protocol) server deployed on Cloudflare Workers, complete with OAuth login. It is intended for developers who want to run MCP servers remotely and connect them to 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. For deployment, create a KV namespace with npx wrangler kv namespace create OAUTH_KV, add the namespace ID to wrangler.jsonc, and run npm run deploy. Connect clients via SSE transport, e.g., using the MCP Inspector or Claude Desktop with the mcp-remote proxy pointing to the server’s /sse endpoint.
Key features of Remote MCP Server on Cloudflare
- Deployable on Cloudflare Workers
- OAuth login for authentication
- SSE transport for MCP communication
- Local development with hot reload
- Simple deployment via Wrangler CLI
Use cases of Remote MCP Server on Cloudflare
- Running a remote math tool that Claude Desktop can invoke
- Testing MCP servers with the MCP Inspector
- Connecting Claude Desktop to a remote MCP server over HTTP
- Providing a secure, OAuth-protected MCP endpoint
FAQ from Remote MCP Server on Cloudflare
What are the prerequisites for running this server?
Node.js, npm, and a Cloudflare account with Wrangler installed.
How do I deploy the server to Cloudflare?
Create a KV namespace with npx wrangler kv namespace create OAUTH_KV, add the ID to wrangler.jsonc, and run npm run deploy.
How do I connect Claude Desktop to the remote server?
Add a configuration entry to Claude Desktop’s config file using mcp-remote as the command and the server’s workers.dev/sse URL as the argument.
How can I debug connection issues?
Restart Claude, try connecting directly via npx mcp-remote http://localhost:8787/sse, or clear cached auth files with rm -rf ~/.mcp-auth.
What transport does the server use?
The server uses SSE (Server-Sent Events) transport.
