概要
What is Remote MCP Server on Cloudflare?
It is a guide and template for running a remote MCP (Model Context Protocol) server on Cloudflare Workers, complete with OAuth login. It is intended for developers who want to deploy and use MCP tools with remote clients like the MCP Inspector or 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 to the server using the MCP Inspector with SSE transport at http://localhost:8787/sse, or configure Claude Desktop to use the local proxy (npx mcp-remote http://localhost:8787/sse). To deploy, create a KV namespace with npx wrangler kv namespace create OAUTH_KV, update wrangler.jsonc, and run npm run deploy.
Key features of Remote MCP Server on Cloudflare
- Runs on Cloudflare Workers as a remote MCP server
- OAuth login via browser-based authentication
- Supports SSE (Server-Sent Events) transport
- Works with MCP Inspector and Claude Desktop
- Deployable to a
workers.devURL
Use cases of Remote MCP Server on Cloudflare
- Connecting Claude Desktop to a remote MCP server hosted on Cloudflare
- Running MCP tools at the edge with Cloudflare Workers
- Developing and testing MCP servers locally with the MCP Inspector
- Distributing an MCP server that requires OAuth authentication
FAQ from Remote MCP Server on Cloudflare
How do I connect the MCP Inspector to my local server?
Open the MCP Inspector (npx @modelcontextprotocol/inspector), switch Transport Type to SSE, enter http://localhost:8787/sse as the MCP server URL, and click “Connect.” You will then see a mock login screen.
How do I connect Claude Desktop to the remote server?
In Claude Desktop, go to Settings > Developer > Edit Config and replace the mcpServers entry with an object using "math" as the key, "command": "npx", "args": ["mcp-remote", "https://<worker-name>.<account>.workers.dev/sse"]. Restart Claude and a browser window will open to log in.
How do I deploy the server to Cloudflare?
Run npx wrangler kv namespace create OAUTH_KV, add the returned KV namespace ID to wrangler.jsonc, then run npm run deploy. The server will be available at your workers.dev URL.
What should I do if something goes wrong?
Restart Claude, or try connecting directly on the command line with npx mcp-remote http://localhost:8787/sse. In rare cases, clear the files in ~/.mcp-auth with rm -rf ~/.mcp-auth.
What transport type does this MCP server use?
It uses SSE (Server-Sent Events) as the transport protocol. Both local and remote clients connect via an SSE endpoint (e.g., /sse).
