Remote MCP Server on Cloudflare

What is Remote MCP Server on Cloudflare?

A template to get a remote MCP (Model Context Protocol) server running on Cloudflare Workers with OAuth login. It is for developers who want to host MCP tools remotely and connect them to clients like Claude Desktop.

How to use Remote MCP Server on Cloudflare?

Clone the repository, install dependencies, and run npx nx dev remote-mcp-server for local development. Use the MCP Inspector with SSE transport (e.g., http://localhost:8787/sse) or configure Claude Desktop with a local proxy using npx mcp-remote. Deploy to Cloudflare by creating a KV namespace (npx wrangler kv namespace create OAUTH_KV), adding its ID to wrangler.jsonc, and running npm run deploy.

Key features of Remote MCP Server on Cloudflare

• Runs MCP server on Cloudflare Workers with OAuth authentication.
• Supports SSE (Server-Sent Events) transport for remote clients.
• Works with MCP Inspector for testing and debugging.
• Integrates with Claude Desktop via the mcp-remote proxy.
• Provides local development workflow with live reload.

Use cases of Remote MCP Server on Cloudflare

• Hosting a remote MCP server for use with MCP-compatible AI clients.
• Testing MCP tools locally with the MCP Inspector.
• Connecting Claude Desktop to a remote MCP server over the internet.
• Prototyping and deploying custom MCP tools on Cloudflare’s edge network.

FAQ from Remote MCP Server on Cloudflare

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

Edit Claude’s configuration file and add an entry for the server with "command": "npx" and "args": ["mcp-remote", "http://localhost:8787/sse"]. Restart Claude and log in through the browser.

How do I deploy to Cloudflare?

Run npx wrangler kv namespace create OAUTH_KV and follow the prompt to add the namespace ID to wrangler.jsonc. Then run npm run deploy.

How do I connect a remote MCP client after deployment?

Use the MCP Inspector with the SSE transport and enter your Worker’s URL (e.g., https://worker-name.account-name.workers.dev/sse) as the server URL, then click “Connect”.

What transport and authentication does the server use?

The server uses SSE (Server-Sent Events) for transport and implements OAuth login. During local development a mock login screen is shown; after deployment OAuth is handled via Cloudflare Workers.

How can I debug connection issues?

Restart Claude, or test connectivity directly with the command npx mcp-remote http://localhost:8787/sse. In rare cases, clear the files in ~/.mcp-auth by running rm -rf ~/.mcp-auth.