Remote MCP Server on Cloudflare

What is Remote MCP Server on Cloudflare?

A ready-to-deploy template that runs an MCP (Model Context Protocol) server on Cloudflare Workers with built-in OAuth login. It provides a starting point for developers who want to host remote MCP servers and connect them to MCP clients like Claude Desktop.

How to use Remote MCP Server on Cloudflare?

Clone the repository, install dependencies with npm install, then run locally with npx nx dev remote-mcp-server. Deploy to Cloudflare using npm run deploy after creating an OAUTH_KV namespace. Connect clients (MCP Inspector, Claude Desktop) via the SSE endpoint http://localhost:8787/sse (local) or https://<worker-name>.<account>.workers.dev/sse (remote) using the mcp-remote proxy.

Key features of Remote MCP Server on Cloudflare

• Runs on Cloudflare Workers with global edge distribution
• OAuth login built in for secure client access
• Local development with hot-reload and mock login
• Connects to Claude Desktop via a local proxy (mcp-remote)
• Uses SSE (Server-Sent Events) transport for MCP communication
• Simple one-command deployment via Wrangler CLI

Use cases of Remote MCP Server on Cloudflare

• Hosting a private remote MCP server for personal AI assistants
• Testing MCP tool definitions locally before deploying to production
• Building a math tool server, as shown in the example configuration
• Integrating MCP-powered workflows with Claude Desktop from anywhere

FAQ from Remote MCP Server on Cloudflare

What dependencies are required?

Node.js and npm for local development, a Cloudflare account, and the Wrangler CLI (npx wrangler) for deployment.

How does authentication work?

The server uses OAuth login; during local development a mock login screen accepts any email and password, while on deployment it uses real OAuth flows.

What transport protocol does the server use?

Server-Sent Events (SSE) – clients connect to the /sse endpoint.

How can I connect Claude Desktop to this server?

Configure Claude’s MCP settings to run npx mcp-remote <server-url>/sse as a proxy command. A browser window will open for OAuth login.

Where is OAuth data stored?

In a Cloudflare KV namespace named OAUTH_KV that must be created before deployment and linked in the wrangler.jsonc configuration file.