Remote MCP Server on Cloudflare

What is Remote MCP Server on Cloudflare?

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

How to use Remote MCP Server on Cloudflare?

Clone the repository, install dependencies, and run locally with npx nx dev remote-mcp-server. For production, use npx wrangler kv namespace create OAUTH_KV, add the KV namespace ID to wrangler.jsonc, then npm run deploy. Connect clients (e.g., MCP Inspector or Claude Desktop) via SSE at the server’s /sse endpoint.

Key features of Remote MCP Server on Cloudflare

• Run MCP tools on Cloudflare Workers.
• OAuth login for authentication.
• Local development with live reload.
• Deployable to a public workers.dev URL.
• Works with MCP Inspector and Claude Desktop.

Use cases of Remote MCP Server on Cloudflare

• Hosting custom MCP tools accessible from any remote client.
• Integrating MCP capabilities into Claude Desktop over the internet.
• Prototyping and testing MCP servers locally before deployment.
• Sharing MCP tools with team members via a public URL.

FAQ from Remote MCP Server on Cloudflare

What runtime does Remote MCP Server on Cloudflare require?

It runs on Cloudflare Workers; local development uses Node.js and the nx task runner. The Worker uses KV (OAuth_KV namespace) for OAuth state.

How do I connect an MCP client to the remote server?

Use the SSE transport. For the MCP Inspector, set Transport Type to SSE and enter <your-worker-url>/sse. For Claude Desktop, configure the mcpServers JSON with "command": "npx", "args": ["mcp-remote", "<your-url>/sse"].

Where does authentication data live?

OAuth tokens and state are stored in the Cloudflare KV namespace named OAUTH_KV.

Can I run multiple MCP servers on the same Worker?

The README focuses on a single MCP server; multiple tools can be defined within that server, but the setup does not show multi-server support.

How do I reset authentication if something goes wrong?

Clear the local auth files with rm -rf ~/.mcp-auth and/or restart Claude.