Remote MCP Server on Cloudflare

What is Remote MCP Server on Cloudflare?

A project that enables you to deploy a remote MCP (Model Context Protocol) server on Cloudflare Workers with OAuth login. It is intended for developers who want to expose MCP tools over the internet and connect them to clients like Claude Desktop or the MCP Inspector.

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. For deployment, create a KV namespace with npx wrangler kv namespace create OAUTH_KV, add the ID to wrangler.jsonc, then run npm run deploy. Connect clients (MCP Inspector, Claude Desktop) using the SSE transport pointing to the server’s /sse endpoint.

Key features of Remote MCP Server on Cloudflare

• OAuth login for authentication
• Can run locally or deployed on Cloudflare Workers
• Communicates via Server-Sent Events (SSE) transport
• Works with the MCP Inspector for testing
• Integrates with Claude Desktop via mcp-remote proxy

Use cases of Remote MCP Server on Cloudflare

• Deploying a custom MCP server remotely for AI assistants
• Developing and testing MCP tools locally with the Inspector
• Connecting Claude Desktop to a self‑hosted, OAuth‑protected MCP server
• Demonstrating or prototyping remote MCP workflows

FAQ from Remote MCP Server on Cloudflare

How do I run the server locally?

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

How do I connect the MCP Inspector?

Set transport type to “SSE” and enter http://localhost:8787/sse (or the remote Workers URL with /sse) as the server URL, then click Connect.

How do I connect Claude Desktop to my server?

Update Claude Desktop’s configuration file to add an mcpServers entry using npx mcp-remote as the command, with the server’s SSE URL (local or remote) as an argument.

How do I deploy the server to Cloudflare?

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

How do I debug connection issues?

Restart Claude Desktop, or test the connection directly with npx mcp-remote http://localhost:8787/sse. If needed, clear the auth files in `~