Remote MCP Server on Cloudflare

What is Remote MCP Server on Cloudflare?

This server enables developers to run a remote Model Context Protocol (MCP) server on Cloudflare Workers, complete with OAuth login. It is intended for developers who need to deploy MCP tools remotely and connect them to clients like Claude Desktop or the MCP Inspector.

How to use Remote MCP Server on Cloudflare?

Clone the repo, install dependencies, and run locally with npx nx dev remote-mcp-server. Deploy to Cloudflare with npx wrangler kv namespace create OAUTH_KV and npm run deploy. Connect clients by pointing them to the server’s SSE endpoint (e.g., http://localhost:8787/sse locally or a workers.dev URL). For Claude Desktop, configure mcpServers with the mcp-remote command pointing to the SSE URL.

Key features of Remote MCP Server on Cloudflare

• Runs as a remote MCP server on Cloudflare Workers.
• Includes OAuth login flow for authentication.
• Uses SSE transport for client-server communication.
• Works with MCP Inspector and Claude Desktop out of the box.
• Provides local development and deployment workflows.

Use cases of Remote MCP Server on Cloudflare

• Running MCP tools remotely and accessing them from any client.
• Connecting Claude Desktop to a secure, cloud-hosted MCP server.
• Deploying scalable MCP infrastructure using Cloudflare Workers.

FAQ from Remote MCP Server on Cloudflare

What transport type does the server use?

The server uses SSE (Server-Sent Events) as the transport protocol.

How do I connect Claude Desktop to the server?

Add an entry to your Claude Desktop configuration file with "command": "npx" and "args": ["mcp-remote", "<SSE-URL>"]. Restart Claude and log in via the browser window that opens.

How do I deploy the server to Cloudflare?

First create a KV namespace with npx wrangler kv namespace create OAUTH_KV and add its ID to wrangler.jsonc. Then run npm run deploy.

How can I debug connection issues?

Restart Claude, or test connectivity directly with npx mcp-remote http://localhost:8787/sse. In rare cases, clear ~/.mcp-auth with rm -rf ~/.mcp-auth.