Remote MCP Server on Cloudflare

What is Remote MCP Server on Cloudflare?

A starter project for deploying a remote MCP (Model Context Protocol) server on Cloudflare Workers with OAuth login. It enables developers to host MCP tools and connect clients like Claude Desktop over SSE.

How to use Remote MCP Server on Cloudflare?

Clone the repository, install dependencies with npm install, then run locally with npx nx dev remote-mcp-server. Deploy by creating a KV namespace (npx wrangler kv namespace create OAUTH_KV), adding its ID to wrangler.jsonc, and running npm run deploy. Connect clients (MCP Inspector or Claude Desktop) using the SSE endpoint at /sse.

Key features of Remote MCP Server on Cloudflare

• Local development with OAuth login (mock)
• SSE transport for MCP communication
• Deploy to Cloudflare Workers
• Integrates with Claude Desktop via mcp-remote proxy
• Works with MCP Inspector for testing

Use cases of Remote MCP Server on Cloudflare

• Hosting a remote MCP server for Claude Desktop
• Testing MCP tools locally before deployment
• Building custom AI tool servers secured with OAuth

FAQ from Remote MCP Server on Cloudflare

What transport type does the server use?

Server Name (SSE) – the MCP Inspector must be configured with Transport Type SSE and the URL set to the server’s /sse endpoint.

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.

How do I connect Claude Desktop to the remote server?

Update Claude Desktop’s config (mcpServers) to use npx mcp-remote with the server’s full workers.dev URL appended with /sse (e.g., https://worker-name.account-name.workers.dev/sse).

How can I debug connection issues?

Restart Claude Desktop, or test direct connectivity with npx mcp-remote http://localhost:8787/sse. If needed, clear cached OAuth data with rm -rf ~/.mcp-auth.