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. It is intended for developers who want to run MCP tools remotely and connect them to clients like Claude Desktop.

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, and deploy to Cloudflare using npm run deploy. To connect a client, use SSE transport at the /sse endpoint (e.g. http://localhost:8787/sse locally or https://worker-name.account-name.workers.dev/sse after deployment).

Key features of Remote MCP Server on Cloudflare

• Remote MCP server hosted on Cloudflare Workers
• OAuth login for secure access
• SSE (Server‑Sent Events) transport
• Local development and debugging support
• Easy deployment with npx wrangler and npm run deploy
• Integration with MCP Inspector and Claude Desktop

Use cases of Remote MCP Server on Cloudflare

• Develop and test MCP tools locally before deploying
• Host a remote MCP server for use with AI clients like Claude Desktop
• Authenticate users via OAuth when accessing the MCP server
• Debug MCP tool calls using the MCP Inspector

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. Open http://localhost:8787/ in a browser.

How do I deploy to Cloudflare?

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

How do I connect Claude Desktop to the server?

Add an entry to your Claude Desktop config file with "command": "npx", "args": ["mcp-remote", "<URL>/sse"]. Use the local http://localhost:8787/sse or the deployed https://worker-name.account-name.workers.dev/sse.

What transport type does the server use?

The server uses SSE (Server‑Sent Events) transport. In the MCP Inspector, set Transport Type to SSE and enter the server’s /sse URL.

How do I debug connection issues?

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