Remote MCP Server on Cloudflare
@nekokuro2nya
Overview
What is Remote MCP Server on Cloudflare?
A template and guide for deploying a remote MCP (Model Context Protocol) server on Cloudflare Workers, complete with OAuth login. It is intended for developers who want to expose MCP tools over the internet and connect them with clients like the MCP Inspector or Claude Desktop.
How to use Remote MCP Server on Cloudflare?
Clone the repository, install dependencies, then run locally with npx nx dev remote-mcp-server. For remote deployment, create a KV namespace (npx wrangler kv namespace create OAUTH_KV), add its ID to wrangler.jsonc, then run npm run deploy. Use the MCP Inspector or Claude Desktop with mcp-remote proxy pointing to the server’s SSE endpoint (e.g., http://localhost:8787/sse locally or https://worker-name.account-name.workers.dev/sse after deployment).
Key features of Remote MCP Server on Cloudflare
- MCP server running on Cloudflare Workers
- OAuth login for authentication
- Uses SSE (Server-Sent Events) transport
- Connects to MCP Inspector and Claude Desktop
- Local development with live reload (Nx)
Use cases of Remote MCP Server on Cloudflare
- Host a math tool MCP server accessible remotely
- Integrate MCP tools with Claude Desktop over the internet
- Develop and test custom MCP tools locally before deploying
- Provide authenticated MCP endpoints for AI clients
FAQ from Remote MCP Server on Cloudflare
How do I run the server locally?
Clone the repo, run npm install, then npx nx dev remote-mcp-server. It will be available at http://localhost:8787/.
What do I need to deploy to Cloudflare?
A Cloudflare Workers account and a KV namespace. Create it with npx wrangler kv namespace create OAUTH_KV, then add the namespace ID to wrangler.jsonc and run npm run deploy.
How can I connect Claude Desktop to this server?
Update the Claude Desktop config file to use mcp-remote as the command and the server's SSE URL as an argument. For local: http://localhost:8787/sse. For remote: https://worker-name.account-name.workers.dev/sse.
How do I debug connection issues?
Restart Claude, or test the server directly with npx mcp-remote http://localhost:8787/sse. Clearing ~/.mcp-auth may help in rare cases.
What authentication does the server use?
It uses OAuth login with a mock login screen during local development and real OAuth when deployed (backed by the OAUTH_KV namespace).
