Remote MCP Server on Cloudflare

What is Remote MCP Server on Cloudflare?

The Remote MCP Server on Cloudflare is a remote Model Context Protocol (MCP) server that runs on Cloudflare Workers with OAuth login. It allows developers to deploy custom MCP tools and connect MCP clients (like the MCP Inspector or Claude Desktop) over SSE transport.

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 open http://localhost:8787/. To connect a client, use the MCP Inspector with SSE transport and URL http://localhost:8787/sse, or configure Claude Desktop with the mcp-remote command and the server’s SSE URL. Deploy with npx wrangler kv namespace create OAUTH_KV, add the KV namespace ID to wrangler.jsonc, then run npm run deploy.

Key features of Remote MCP Server on Cloudflare

• Runs on Cloudflare Workers with OAuth login
• Supports SSE transport for MCP clients
• Local development with npx nx dev remote-mcp-server
• Connect via MCP Inspector or Claude Desktop
• Deployable to a workers.dev URL
• Includes a mock login screen for local testing

Use cases of Remote MCP Server on Cloudflare

• Deploying a remote MCP server for custom tools
• Testing MCP tool calls with the MCP Inspector
• Integrating MCP tools with Claude Desktop
• Developing and debugging MCP servers locally
• Using Cloudflare Workers as an MCP hosting platform

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. The server will be available at http://localhost:8787/.

How do I connect the MCP Inspector to my server?

Start the MCP Inspector with npx @modelcontextprotocol/inspector, switch Transport Type to SSE, enter the server’s SSE URL (e.g., http://localhost:8787/sse), and click “Connect”. You will see a mock login screen – enter any email and password to proceed.

How do I connect Claude Desktop?

Open Claude Desktop’s configuration file (Settings > Developer > Edit Config) and add an entry using npx mcp-remote with the server’s SSE URL (e.g., http://localhost:8787/sse for local, or https://worker-name.account-name.workers.dev/sse for remote).

How do I deploy to Cloudflare?

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

How do I debug connection issues?

Try npx mcp-remote http://localhost:8787/sse directly, or clear cached auth files with rm -rf ~/.mcp-auth. Restarting Claude may also help.