Remote MCP Server on Cloudflare

What is Remote MCP Server on Cloudflare?

Remote MCP Server on Cloudflare is a guide and template to deploy a remote Model Context Protocol (MCP) server on Cloudflare Workers with OAuth login. It is intended for developers who want to host MCP servers accessible over the internet, complete with authentication.

How to use Remote MCP Server on Cloudflare?

Clone the repository, install dependencies (npm install), and run locally with npx nx dev remote-mcp-server. For production, deploy using npm run deploy after configuring a KV namespace. Connect clients via the MCP Inspector or Claude Desktop using the mcp-remote proxy and the server’s SSE endpoint (e.g., http://localhost:8787/sse locally or worker-name.account-name.workers.dev/sse after deployment).

Key features of Remote MCP Server on Cloudflare

• Runs on Cloudflare Workers for scalable hosting.
• Includes OAuth-based login for secure access.
• Uses Server-Sent Events (SSE) as the transport.
• Supports local development and remote deployment.
• Integrates with MCP Inspector and Claude Desktop.
• Provides a mock login for local testing.

Use cases of Remote MCP Server on Cloudflare

• Hosting MCP tools on the edge with Cloudflare Workers.
• Testing MCP servers locally using the MCP Inspector.
• Connecting Claude Desktop to remote MCP tools via a proxy.
• Adding OAuth authentication to MCP interactions.
• Rapid prototyping and debugging of MCP-based workflows.

FAQ from Remote MCP Server on Cloudflare

What transport protocol does the remote MCP server use?

It uses Server-Sent Events (SSE). The local endpoint is http://localhost:8787/sse and the remote endpoint is https://worker-name.account-name.workers.dev/sse.

How do I connect Claude Desktop to the server?

In Claude Desktop’s config file, add an entry using the npx mcp-remote command pointing to the server’s SSE URL, for example: "command": "npx", "args": ["mcp-remote", "http://localhost:8787/sse"].

How do I handle authentication locally?

When testing locally, the MCP Inspector or Claude Desktop will navigate to a mock login screen where you can input any email and password to log in.

How do I deploy to Cloudflare?

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

How can I debug connection issues?

Restart Claude, try connecting with npx mcp-remote http://localhost:8787/sse from the command line, or clear the ~/.mcp-auth directory.