Remote MCP Server on Cloudflare

What is Remote MCP Server on Cloudflare?

Remote MCP Server on Cloudflare is a starter kit that lets you run an MCP (Model Context Protocol) server on Cloudflare Workers with OAuth login. It is intended for developers who want to host MCP tools accessible over the internet and connect them to clients like Claude Desktop.

How to use Remote MCP Server on Cloudflare?

Clone the repository, install dependencies, and run locally with npx nx dev remote-mcp-server. To deploy to Cloudflare, create an KV namespace with npx wrangler kv namespace create OAUTH_KV, add the namespace ID to wrangler.jsonc, and run npm run deploy. Connect to the server using the MCP Inspector (npx @modelcontextprotocol/inspector) with SSE transport at the server’s /sse URL, or configure Claude Desktop with an mcp-remote proxy pointing to the same endpoint.

Key features of Remote MCP Server on Cloudflare

• OAuth login built into the server.
• Local development with hot reload.
• Deploy to Cloudflare Workers with a single command.
• Supports SSE (Server-Sent Events) transport.
• Works with MCP Inspector for exploration.
• Integrates with Claude Desktop via mcp-remote proxy.

Use cases of Remote MCP Server on Cloudflare

• Hosting MCP tools on a scalable serverless platform.
• Connecting Claude Desktop to remote MCP tools over the internet.
• Testing and debugging MCP tools locally before deployment.
• Building and experimenting with custom MCP servers that require authentication.

FAQ from Remote MCP Server on Cloudflare

How do I connect the MCP Inspector to my server?

Run npx @modelcontextprotocol/inspector, switch Transport Type to SSE, and enter the server’s SSE URL (e.g., http://localhost:8787/sse). Click “Connect” and log in with any email and password.

How do I connect Claude Desktop to a remote MCP server?

Edit the Claude Desktop configuration file (mcpServers section) to use the mcp-remote command with the server’s SSE URL. For example: "command": "npx", "args": ["mcp-remote", "https://worker-name.account-name.workers.dev/sse"].

How do I deploy the server to Cloudflare?

Create a KV namespace with npx wrangler kv namespace create OAUTH_KV, add the namespace ID to wrangler.jsonc, and run npm run deploy. The server will be available at a workers.dev URL.

What transport protocol does the server use?

The server uses SSE (Server-Sent Events) for communication. Clients connect to the /sse endpoint.

How can I debug connection issues?

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