Remote MCP Server on Cloudflare

What is Remote MCP Server on Cloudflare?

Remote MCP Server on Cloudflare is a guide and codebase for deploying a Model Context Protocol (MCP) server on Cloudflare Workers, complete with OAuth login. It enables developers to host 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, and run locally via npx nx dev remote-mcp-server. Use the MCP Inspector (npx @modelcontextprotocol/inspector) with SSE transport at http://localhost:8787/sse. For production, deploy with npx wrangler kv namespace create OAUTH_KV, update wrangler.jsonc, and run npm run deploy. Connect Claude Desktop by adding an mcpServers entry pointing to https://your-worker.workers.dev/sse using npx mcp-remote.

Key features of Remote MCP Server on Cloudflare

• Runs MCP server on Cloudflare Workers.
• Includes OAuth login integration.
• Supports SSE transport for remote access.
• Works with MCP Inspector for testing.
• Connects to Claude Desktop via remote proxy.
• Uses Cloudflare KV for OAuth state.

Use cases of Remote MCP Server on Cloudflare

• Hosting custom MCP tools on a serverless platform.
• Prototyping remote MCP servers with authentication.
• Integrating Claude Desktop with externally hosted MCP tools.
• Testing MCP server functionality using the MCP Inspector.
• Deploying a production-ready remote MCP server.

FAQ from Remote MCP Server on Cloudflare

How do I run the server locally?

Clone the repo, install dependencies, and run npx nx dev remote-mcp-server. The server will be available at http://localhost:8787/.

How do I connect Claude Desktop to the server?

Add an entry to your Claude Desktop config file using "npx mcp-remote" with the SSE URL of your server (e.g., http://localhost:8787/sse for local, or the workers.dev URL after deployment). Restart Claude.

How do I deploy the server to Cloudflare?

Create a Cloudflare KV namespace with npx wrangler kv namespace create OAUTH_KV, add the namespace ID to wrangler.jsonc, then run npm run deploy. Your server will be available at worker-name.account-name.workers.dev.

How do I test the server with MCP Inspector?

Run npx @modelcontextprotocol/inspector, set Transport Type to SSE, enter your server’s /sse URL, and click Connect. Complete the OAuth login to list and call tools.

How do I debug connection issues?

Try restarting Claude, or connect directly via CLI using npx mcp-remote with the SSE URL. In rare cases, clear local authentication files with rm -rf ~/.mcp-auth.