Remote MCP Server on Cloudflare

What is Remote MCP Server on Cloudflare?

A guide and starter code to deploy a remote MCP (Model Context Protocol) server on Cloudflare Workers with OAuth login. Designed for developers who want to expose MCP tools over the internet and connect them to AI clients such as Claude Desktop.

How to use Remote MCP Server on Cloudflare?

Clone the repository, install dependencies, and run locally with npx nx dev remote-mcp-server. Connect via MCP Inspector using SSE at http://localhost:8787/sse. For production, create a KV namespace, update wrangler.jsonc, and deploy with npm run deploy. Configure any MCP client (e.g., Claude Desktop) to point to the deployed /sse endpoint using the mcp-remote proxy.

Key features of Remote MCP Server on Cloudflare

• Runs on Cloudflare Workers at the edge
• Includes OAuth-based authentication flow
• Supports SSE (Server-Sent Events) transport
• Works with MCP Inspector for testing
• Connects to Claude Desktop via mcp-remote
• Local development with instant hot reload

Use cases of Remote MCP Server on Cloudflare

• Deploy a custom MCP server accessible from anywhere
• Securely expose MCP tools to AI assistants like Claude
• Prototype and iterate MCP tools locally before production
• Use Cloudflare’s global network for low-latency MCP endpoints

FAQ from Remote MCP Server on Cloudflare

How do I connect Claude Desktop to my local MCP server?

Edit your Claude configuration file to add an mcpServers entry using npx mcp-remote http://localhost:8787/sse. Restart Claude and you should see the available tools.

How do I deploy the MCP server to Cloudflare?

Run npx wrangler kv namespace create OAUTH_KV, add the returned KV namespace ID to wrangler.jsonc, then execute npm run deploy.

What should I do if something goes wrong?

Restart Claude, or try connecting directly to your MCP server with npx mcp-remote http://localhost:8787/sse. In rare cases, clear the auth files with rm -rf ~/.mcp-auth.

How can I test my MCP server remotely?

Use the MCP Inspector: run npx @modelcontextprotocol/inspector, set Transport Type to SSE, and enter your deployed workers.dev/sse URL (e.g., worker-name.account-name.workers.dev/sse).

What transport does the server use?

The server communicates via SSE (Server-Sent Events) over HTTP, as shown in the development and production connection URLs ending in /sse.