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 with OAuth login, enabling secure tool access from MCP clients.

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 npm run deploy after creating a KV namespace. Connect clients like the MCP Inspector or Claude Desktop by pointing them to the server’s SSE endpoint.

Key features of Remote MCP Server on Cloudflare

• Run MCP server locally or deploy to Cloudflare Workers
• Built-in OAuth authentication flow
• Uses SSE (Server-Sent Events) transport
• Works with MCP Inspector and Claude Desktop
• Easy configuration via wrangler.jsonc and KV storage

Use cases of Remote MCP Server on Cloudflare

• Develop and test custom MCP tools in a local environment
• Deploy a remotely accessible MCP server with user login
• Integrate MCP tools with Claude Desktop for AI workflows

FAQ from Remote MCP Server on Cloudflare

How do I run the server locally?

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

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 the server?

Add an MCP server entry to your Claude config using npx mcp-remote with either the local URL (http://localhost:8787/sse) or the deployed workers.dev URL.

What transport protocol does the server use?

It uses SSE (Server-Sent Events) at the /sse endpoint. The MCP Inspector and mcp-remote connect via this URL.

How can I debug connection issues?

Restart Claude, try connecting directly with npx mcp-remote http://localhost:8787/sse, or clear ~/.mcp-auth if auth data is corrupted.