Remote MCP Server on Cloudflare

What is Remote MCP Server on Cloudflare?

Remote MCP Server on Cloudflare is a template for deploying a Model Context Protocol (MCP) server on Cloudflare Workers with OAuth login. It enables remote access to MCP tools over SSE, complete with authentication and a local development workflow.

How to use Remote MCP Server on Cloudflare?

Clone the repository, install dependencies with npm install, and run locally with npx nx dev remote-mcp-server. To deploy, create a KV namespace with npx wrangler kv namespace create OAUTH_KV, add the ID to wrangler.jsonc, then run npm run deploy. Connect clients via the MCP Inspector (SSE at /sse) or Claude Desktop using the mcp-remote proxy configured with your server’s URL.

Key features of Remote MCP Server on Cloudflare

• OAuth login for secure access to tools
• Deployable as a Cloudflare Worker
• Uses SSE (Server‑Sent Events) transport
• Local development with hot‑reload support
• Demo math tool (add, multiply, etc.) pre‑included
• Remote client connection via mcp-remote proxy

Use cases of Remote MCP Server on Cloudflare

• Deploy a privately accessible MCP server on the edge
• Connect Claude Desktop to a remote MCP server over the internet
• Develop and test MCP tools locally with the MCP Inspector
• Add authentication to any MCP server using Cloudflare Workers

FAQ from Remote MCP Server on Cloudflare

What is Remote MCP Server on Cloudflare?

It is a ready‑to‑deploy MCP server on Cloudflare Workers that includes OAuth login and a sample math tool. It can be run locally or deployed globally.

How do I deploy the server?

Create a KV namespace for OAuth tokens, update wrangler.jsonc with its ID, and run npm run deploy. The server will be available at a workers.dev URL.

What dependencies are required?

Node.js, npm, and the Cloudflare Wrangler CLI (npx wrangler). The project uses the Nx monorepo tool and the mcp-remote proxy for client connections.

How do I connect Claude Desktop to the remote server?

Update Claude’s configuration file to use the mcp-remote command with your workers.dev URL (e.g., https://worker-name.account-name.workers.dev/sse). Restart Claude after editing.

How can I debug connection issues?

Restart Claude or test the server directly with npx mcp-remote <url>. If auth problems persist, clear the local cache with rm -rf ~/.mcp-auth.