Remote MCP Server on Cloudflare

What is Remote MCP Server on Cloudflare?

Remote MCP Server on Cloudflare is a guide and codebase for deploying a Model Context Protocol (MCP) server on Cloudflare Workers, complete with OAuth login. It enables you to run MCP tools remotely and connect clients such as Claude Desktop or the MCP Inspector.

How to use Remote MCP Server on Cloudflare?

Clone the repository, install dependencies, and run locally with npx nx dev remote-mcp-server. Deploy to Cloudflare with npm run deploy after setting up a KV namespace. Connect clients by pointing them to the server’s SSE endpoint (e.g., http://localhost:8787/sse locally or https://worker-name.account-name.workers.dev/sse after deployment). Use the MCP Inspector with SSE transport, or configure Claude Desktop by adding an mcp-remote entry in its configuration file.

Key features of Remote MCP Server on Cloudflare

• Deploys on Cloudflare Workers for global availability
• Includes OAuth login flow with mock login locally
• Uses SSE (Server-Sent Events) transport
• Supports local development and debugging
• Provides step-by-step deployment instructions
• Can be connected to Claude Desktop via a local proxy

Use cases of Remote MCP Server on Cloudflare

• Deploying custom MCP tools accessible over the internet
• Connecting Claude Desktop to a remote MCP server with authentication
• Testing MCP tools locally before production deployment
• Building and sharing MCP tools with OAuth-based access control

FAQ from Remote MCP Server on Cloudflare

What are the runtime and dependency requirements?

Requires Node.js, npm, and a Cloudflare account for deployment. For local development, clone the repo and run npm install.

How does authentication work?

Locally, a mock login screen accepts any email and password. When deployed, OAuth is used with tokens stored in a Cloudflare KV namespace named OAUTH_KV.

What transport protocol does the server use?

The server uses SSE (Server-Sent Events) over HTTP. Clients connect to the /sse endpoint.

How do I connect Claude Desktop to the remote server?

Add an entry to Claude Desktop’s configuration file using the mcp-remote command pointing to the server’s SSE URL (e.g., https://worker-name.account-name.workers.dev/sse). A browser window will open for login.

Where are OAuth tokens stored?

Tokens are stored in a Cloudflare KV namespace (OAUTH_KV) that must be created and linked to the Worker before deployment.