Remote MCP Server on Cloudflare

What is Remote MCP Server on Cloudflare?

A starter project to deploy a remote MCP (Model Context Protocol) server on Cloudflare Workers, complete with OAuth login for authentication. It is intended for developers who want to run an MCP server remotely using Cloudflare's infrastructure.

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. For production, create a KV namespace with npx wrangler kv namespace create OAUTH_KV, update wrangler.jsonc, and deploy with npm run deploy. Connect clients like the MCP Inspector or Claude Desktop by pointing them to the server's SSE endpoint (e.g., http://localhost:8787/sse locally or a workers.dev URL remotely).

Key features of Remote MCP Server on Cloudflare

• Deployed as a Cloudflare Worker.
• OAuth-based login for authentication.
• Communicates via SSE (Server-Sent Events) transport.
• Supports the MCP Inspector for testing.
• Works with Claude Desktop via the mcp-remote proxy.
• Includes local development workflow with nx.

Use cases of Remote MCP Server on Cloudflare

• Running a remote MCP server accessible from any MCP client.
• Prototyping and testing MCP tools locally before deploying.
• Connecting Claude Desktop to a cloud-hosted MCP server.
• Demonstrating OAuth integration with an MCP endpoint.

FAQ from Remote MCP Server on Cloudflare

How do I develop the server locally?

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

How can I test my MCP tools?

Use the MCP Inspector: run npx @modelcontextprotocol/inspector, set Transport Type to SSE, enter http://localhost:8787/sse (or the remote Workers URL) as the server URL, and connect. After logging in with any email/password (on local), you can list and call tools.

How do I connect Claude Desktop to the server?

Edit Claude Desktop's config file and add an mcpServers entry with command: "npx" and args: ["mcp-remote", "http://localhost:8787/sse"] (or the remote Workers URL). Restart Claude Desktop—a browser login window will appear, and tools will be available.

What do I need to deploy to Cloudflare?

You must create a KV namespace (npx wrangler kv namespace create OAUTH_KV), add its ID to wrangler.jsonc, and then run npm run deploy. No other infrastructure is mentioned.

How can I debug connection issues?

Restart Claude Desktop, or test the MCP server directly from the command line with npx mcp-remote http://localhost:8787/sse. As a last resort, clear stored auth files with rm -rf ~/.mcp-auth.