Remote MCP Server on Cloudflare

What is Remote MCP Server on Cloudflare?

Remote MCP Server on Cloudflare is a starter template to deploy a remote MCP (Model Context Protocol) server on Cloudflare Workers with OAuth login. It is intended for developers who want to run MCP tools on Cloudflare’s edge 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, and run locally with npx nx dev remote-mcp-server. For remote MCP clients, use the MCP Inspector or configure Claude Desktop with an mcp-remote proxy pointing to the SSE endpoint (e.g., http://localhost:8787/sse locally or your workers.dev URL after deployment). Deploy by creating a KV namespace for OAuth and running npm run deploy. Default mock login accepts any email and password.

Key features of Remote MCP Server on Cloudflare

• Run MCP server locally or on Cloudflare Workers
• Built-in OAuth login flow (mock for local dev)
• Uses SSE (Server-Sent Events) transport for MCP communication
• Integrates with MCP Inspector for testing and debugging
• Connects to Claude Desktop via the mcp-remote proxy tool
• Simple deployment with wrangler and a KV namespace

Use cases of Remote MCP Server on Cloudflare

• Prototype an MCP server locally before deploying to the cloud
• Host a public, remote MCP server on Cloudflare Workers
• Enable Claude Desktop to call custom tools over the internet
• Build and test MCP tools with the official MCP Inspector

FAQ from Remote MCP Server on Cloudflare

How do I deploy the server to Cloudflare?

Run npx wrangler kv namespace create OAUTH_KV, add the returned KV namespace ID to wrangler.jsonc, then run npm run deploy. Your server will be available at a workers.dev URL (e.g., worker-name.account-name.workers.dev/sse).

How can I debug connection issues?

Restart Claude Desktop or test the server directly from the command line with npx mcp-remote http://localhost:8787/sse. In rare cases, clear the files in ~/.mcp-auth using rm -rf ~/.mcp-auth.

What transport does the server use?

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

Does the server include authentication?

Yes, the server includes an OAuth login flow. In local development, a mock login screen accepts any email and password. When deployed, authentication is handled via OAuth.

How do I connect Claude Desktop to the server?

Update Claude Desktop’s configuration file to include an mcp-remote entry pointing to the SSE URL of your server (local or remote), then restart Claude Desktop.