Remote MCP Server on Cloudflare

What is Remote MCP Server on Cloudflare?

Remote MCP Server on Cloudflare is a reference implementation for deploying a remote MCP (Model Context Protocol) server on Cloudflare Workers, complete with OAuth login. It is intended for developers who want to run an MCP server accessible from remote clients such as the MCP Inspector or 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. For remote access, deploy to Cloudflare using npx wrangler kv namespace create OAUTH_KV, add the KV namespace ID to wrangler.jsonc, and run npm run deploy. Connect clients like MCP Inspector or Claude Desktop via SSE at the /sse endpoint.

Key features of Remote MCP Server on Cloudflare

• Runs on Cloudflare Workers for serverless deployment.
• Integrates OAuth login for secure access.
• Supports local development with live reload.
• Works with MCP Inspector for tool discovery and testing.
• Connects to Claude Desktop via a local proxy (mcp-remote).
• Uses SSE (Server-Sent Events) transport.

Use cases of Remote MCP Server on Cloudflare

• Host a remote MCP server with OAuth authentication.
• Test MCP tools locally with the MCP Inspector.
• Connect custom tools to Claude Desktop over the internet.
• Deploy a production-ready remote MCP endpoint.

FAQ from Remote MCP Server on Cloudflare

How do I run the server locally?

Clone the repo, run npm install, then execute npx nx dev remote-mcp-server and open http://localhost:8787/.

How do I connect the MCP Inspector to my local server?

Start npx @modelcontextprotocol/inspector, switch transport to SSE, enter http://localhost:8787/sse, and log in with any email/password (mock auth).

How do I connect Claude Desktop to the server?

Add a configuration entry to Claude Desktop's config file using npx mcp-remote with the local or remote URL (e.g., http://localhost:8787/sse or https://worker-name.account-name.workers.dev/sse).

How do I deploy to Cloudflare?

Create a KV namespace with npx wrangler kv namespace create OAUTH_KV, add its ID to wrangler.jsonc, and run npm run deploy.

What if something goes wrong?

Try restarting Claude, clear ~/.mcp-auth with rm -rf ~/.mcp-auth, or test the server directly with npx mcp-remote <url>.