Remote MCP Server on Cloudflare

What is Remote MCP Server on Cloudflare?

A template to set up a remote MCP (Model Context Protocol) server on Cloudflare Workers with OAuth login. Developers use it to expose MCP tools over HTTP and connect them to clients like Claude Desktop or the MCP Inspector.

How to use Remote MCP Server on Cloudflare?

Clone the repository, install dependencies, and run npx nx dev remote-mcp-server for local development. Deploy to Cloudflare with npm run deploy after creating a KV namespace (OAUTH_KV). Connect clients using the SSE endpoint (/sse), optionally via the mcp-remote proxy for Claude Desktop.

Key features of Remote MCP Server on Cloudflare

• Runs as a Cloudflare Worker
• Built-in OAuth login flow
• Uses SSE transport for MCP
• Works with MCP Inspector and Claude Desktop
• Local development with live reload
• Easily deployable via Wrangler

Use cases of Remote MCP Server on Cloudflare

• Host a custom MCP server with user authentication
• Enable Claude Desktop to call remote tools securely
• Prototype and test MCP APIs locally before deployment
• Integrate MCP tools into a serverless architecture

FAQ from Remote MCP Server on Cloudflare

What transport protocol does the server use?

The server uses SSE (Server-Sent Events) over HTTP, with the endpoint at /sse.

How do I connect Claude Desktop to the remote server?

Use the mcp-remote proxy: set the command to npx with args ["mcp-remote", "https://your-worker.workers.dev/sse"] in Claude’s config file.

What dependencies are needed for development?

You need Node.js, npm, and a Cloudflare account. The project uses nx for local development and wrangler for deployment.

How is OAuth authentication handled?

The server includes a mock login screen for local development and uses a Cloudflare KV namespace (OAUTH_KV) for storing session data in production.

How do I debug connection issues?

Restart Claude, test the server directly via npx mcp-remote <url>, or clear the local auth cache with rm -rf ~/.mcp-auth.