Remote MCP Server on Cloudflare

What is Remote MCP Server on Cloudflare?

A template for deploying a remote Model Context Protocol (MCP) server on Cloudflare Workers, complete with OAuth login. It enables developers to build and host MCP tools that can be called from remote MCP clients over HTTP.

How to use Remote MCP Server on Cloudflare?

Clone the repository, install dependencies with pnpm, run locally via npx nx dev remote-mcp-server, and connect using the MCP Inspector or Claude Desktop. For deployment, create a KV namespace with wrangler, add its ID to wrangler.jsonc, then run npm run deploy. Clients connect to the /sse endpoint using an SSE transport proxy.

Key features of Remote MCP Server on Cloudflare

• Runs on Cloudflare Workers with OAuth login flow
• Local development with pnpm and nx
• Uses SSE transport for MCP communication
• Example includes math tools (add, multiply)
• Connectable from MCP Inspector or Claude Desktop
• Deployable to a workers.dev URL

Use cases of Remote MCP Server on Cloudflare

• Hosting remote MCP tools accessible over HTTP
• Building authenticated MCP servers with OAuth
• Integrating MCP tools into Claude Desktop via remote endpoint
• Prototyping and testing MCP tools locally before deployment

FAQ from Remote MCP Server on Cloudflare

What transport does the server use?

It uses Server-Sent Events (SSE) – connect to the /sse endpoint.

How do I connect Claude Desktop to my remote server?

Add an entry to your Claude Desktop config using npx mcp-remote with the server’s workers.dev URL ending in /sse.

How do I deploy the server to Cloudflare?

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

How can I debug connection issues?

Restart Claude, test directly with npx mcp-remote http://localhost:8787/sse, or clear cached auth files with rm -rf ~/.mcp-auth.

Where can I run the server locally?

It runs at http://localhost:8787/ when started with the development command.