Remote MCP Server on Cloudflare

What is Remote MCP Server on Cloudflare?

A starter project to run a remote MCP (Model Context Protocol) server on Cloudflare Workers with OAuth login. It lets developers expose MCP tools over HTTP from a serverless edge environment.

How to use Remote MCP Server on Cloudflare?

Clone the repository, install dependencies, and run locally with npx nx dev remote-mcp-server. Deploy to Cloudflare using wrangler kv namespace create OAUTH_KV and npm run deploy. Connect MCP clients (MCP Inspector or Claude Desktop) via SSE at the server's /sse endpoint.

Key features of Remote MCP Server on Cloudflare

• Runs on Cloudflare Workers for global edge deployment.
• Includes OAuth login flow for authentication.
• Supports SSE (Server‑Sent Events) transport.
• Local development with live reload (nx dev).
• Uses mcp-remote proxy for Claude Desktop integration.
• Persistent auth state via Cloudflare KV namespace.

Use cases of Remote MCP Server on Cloudflare

• Deploy MCP tools as a remote API accessible from any MCP client.
• Connect Claude Desktop to custom MCP tool servers hosted on Cloudflare.
• Prototype and test MCP servers locally before deploying to production.
• Add OAuth‑protected MCP endpoints for secure remote access.

FAQ from Remote MCP Server on Cloudflare

What transport does the server use?

The server communicates over SSE. Clients connect to the /sse endpoint.

How do I authenticate?

The server implements an OAuth login flow. During local development a mock login screen appears; after deployment real OAuth is used.

What runtime or dependencies are required?

Node.js and npm are needed for local development. Deployment requires a Cloudflare account and the Wrangler CLI.

Where does authentication data live?

OAuth state is stored in a Cloudflare KV namespace (OAUTH_KV) that you create during deployment.

How do I debug connection issues?

Restart Claude, or test directly with npx mcp-remote http://localhost:8787/sse. Clearing ~/.mcp-auth can resolve stale auth files.