Remote MCP Server on Cloudflare

What is Remote MCP Server on Cloudflare?

This project provides a remote MCP (Model Context Protocol) server that runs on Cloudflare Workers with OAuth login. It is designed for developers who want to deploy an MCP server accessible over the internet and connect it to clients like the MCP Inspector or 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. Deploy to Cloudflare using npx wrangler kv namespace create OAUTH_KV (adding the KV namespace ID to wrangler.jsonc) then npm run deploy. Connect clients by pointing them to the server’s SSE endpoint (e.g., http://localhost:8787/sse locally or the deployed workers.dev URL).

Key features of Remote MCP Server on Cloudflare

• Deploys as a remote MCP server on Cloudflare Workers
• Includes OAuth login for authentication
• Uses SSE (Server-Sent Events) transport for MCP communication
• Works with MCP Inspector for testing and debugging
• Integrates directly with Claude Desktop via a local proxy
• Supports both local development and production deployment

Use cases of Remote MCP Server on Cloudflare

• Deploying a public MCP server that can be accessed from anywhere
• Testing MCP tools and resources with the MCP Inspector
• Connecting Claude Desktop to custom MCP tools hosted remotely
• Learning how to build and deploy an MCP server on Cloudflare Workers

FAQ from Remote MCP Server on Cloudflare

How do I run the server locally?

Clone the repo, run npm install, then npx nx dev remote-mcp-server. The server will be available at http://localhost:8787/.

How do I deploy the server to Cloudflare?

Create a KV namespace with npx wrangler kv namespace create OAUTH_KV, add its ID to wrangler.jsonc, then run npm run deploy. Your server will be live at <worker-name>.<account-name>.workers.dev.

How do I connect Claude Desktop to the remote MCP server?

Edit Claude Desktop’s configuration file (Settings > Developer > Edit Config) and add an entry using npx mcp-remote with the URL of the server’s SSE endpoint (e.g., "https://worker-name.account-name.workers.dev/sse"). Restart Claude.

How can I debug connectivity issues?

Restart Claude, or try connecting directly from the command line with npx mcp-remote <server-url>. If needed, clear cached auth files with rm -rf ~/.mcp-auth.

What transport protocol does the server use?

The server uses SSE (Server-Sent Events) transport, as indicated by the SSE endpoint (/sse) required by both the MCP Inspector and Claude Desktop.