Remote MCP Server on Cloudflare

What is Remote MCP Server on Cloudflare?

A starter project that sets up a remote MCP (Model Context Protocol) server on Cloudflare Workers, complete with OAuth login flow for authentication.

How to use Remote MCP Server on Cloudflare?

Clone the repository, install dependencies with npm install, run locally with npx nx dev remote-mcp-server, then deploy using npm run deploy after creating a KV namespace. Connect clients such as the MCP Inspector or Claude Desktop by pointing them to the server’s /sse endpoint.

Key features of Remote MCP Server on Cloudflare

• Runs as a Cloudflare Worker with SSE transport
• Built-in OAuth login via mock authentication
• Local development with live reload
• One-command deployment to Cloudflare’s global network
• Works with MCP Inspector and Claude Desktop

Use cases of Remote MCP Server on Cloudflare

• Host a custom MCP server accessible from any remote client
• Securely expose MCP tools with OAuth-based user login
• Prototype and test MCP tools locally before deploying

FAQ from Remote MCP Server on Cloudflare

How do I deploy the server to Cloudflare?

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

How do I connect Claude Desktop to a remote server?

Edit the Claude Desktop config file to use npx mcp-remote <your-workers-url>/sse as the command and arguments.

What transport does the server use?

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

How do I debug connection issues?

Run npx mcp-remote http://localhost:8787/sse directly from the command line, or clear local authentication data with rm -rf ~/.mcp-auth.