Remote MCP Server on Cloudflare

What is Remote MCP Server on Cloudflare?

A template for running a remote MCP (Model Context Protocol) server on Cloudflare Workers, complete with OAuth login. It is intended for developers who want to expose MCP tools over the internet and connect them to AI assistants like Claude Desktop.

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 to Cloudflare using npx wrangler kv namespace create OAUTH_KV and npm run deploy. Connect clients (MCP Inspector or Claude Desktop) via SSE at the server’s /sse endpoint.

Key features of Remote MCP Server on Cloudflare

• Local development with mock OAuth login
• One‑command deployment to Cloudflare Workers
• OAuth‑protected endpoints for secure access
• SSE (Server‑Sent Events) transport for MCP
• Compatible with MCP Inspector and Claude Desktop

Use cases of Remote MCP Server on Cloudflare

• Hosting custom math, search, or other MCP tools remotely
• Connecting Claude Desktop to cloud‑hosted tools via OAuth
• Testing MCP server behavior with the MCP Inspector
• Building a production‑ready remote MCP server skeleton

FAQ from Remote MCP Server on Cloudflare

How do I test the server locally?

Run npx nx dev remote-mcp-server and open http://localhost:8787/. Use the MCP Inspector with SSE transport at http://localhost:8787/sse and log in with any email/password.

How do I deploy the server to Cloudflare?

Create a KV namespace with npx wrangler kv namespace create OAUTH_KV, add the namespace ID to wrangler.jsonc, then run npm run deploy. Your server will be available at a workers.dev URL.

How do I connect Claude Desktop to the remote server?

Edit the Claude Desktop config file (mcpServers entry) to use npx mcp-remote with the server’s /sse URL (e.g., https://worker-name.account-name.workers.dev/sse). Restart Claude and log in via the browser window.

What dependencies are required?

Node.js, npm, a Cloudflare account, and the wrangler CLI. The local proxy for Claude Desktop uses the mcp-remote npm package.

How can I debug connection issues?

Restart Claude or try connecting directly via npx mcp-remote http://localhost:8787/sse (or the remote URL). If authentication problems persist, clear ~/.mcp-auth with rm -rf ~/.mcp-auth.