Remote MCP Server on Cloudflare

What is Remote MCP Server on Cloudflare?

A remote MCP server deployed on Cloudflare Workers with built-in OAuth login, enabling developers to run Model Context Protocol tools over SSE (Server-Sent Events) and connect to them from local or remote clients.

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. Deploy to Cloudflare by creating a KV namespace (npx wrangler kv namespace create OAUTH_KV), adding its ID to wrangler.jsonc, then running npm run deploy. Connect clients via the MCP Inspector or Claude Desktop using an SSE URL (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

• OAuth login integrated into the MCP server.
• Runs on Cloudflare Workers for global availability.
• Uses SSE transport for remote connections.
• Local development supported with a mock login screen.
• Compatible with MCP Inspector and Claude Desktop.
• Deployable with a single command using Wrangler.

Use cases of Remote MCP Server on Cloudflare

• Host MCP tools as a remote service accessible over the internet.
• Connect Claude Desktop to an MCP server without running it locally.
• Test and debug MCP tools interactively with the MCP Inspector.
• Deploy edge-hosted MCP servers using Cloudflare’s infrastructure.

FAQ from Remote MCP Server on Cloudflare

What Cloudflare services are required?

A Cloudflare Workers KV namespace (created via wrangler kv namespace create OAUTH_KV) is required for OAuth storage.

How do I connect Claude Desktop to the remote server?

Add a configuration entry in Claude Desktop’s mcpServers using npx mcp-remote with the SSE URL (e.g., https://worker-name.account-name.workers.dev/sse). The server’s OAuth login will open in a browser window.

Can I develop and test locally before deploying?

Yes. Run npx nx dev remote-mcp-server to start a local instance at http://localhost:8787/. Use the MCP Inspector with http://localhost:8787/sse to test, and a mock login screen appears for authentication.

How do I deploy the server to Cloudflare?

Create a KV namespace with npx wrangler kv namespace create OAUTH_KV, add the returned ID to wrangler.jsonc, then run npm run deploy. The server will be available at a workers.dev URL.

What transport protocol does the server use?

It uses Server-Sent Events (SSE) via the /sse endpoint. All client connections (Inspector, Claude Desktop, CLI) must point to this URL.