Remote MCP Server on Cloudflare

What is Remote MCP Server on Cloudflare?

A guide and template for running a remote MCP (Model Context Protocol) server on Cloudflare Workers with OAuth login, enabling tools to be called from remote MCP 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. Deploy to Cloudflare using npm run deploy after creating a KV namespace. Connect clients (e.g., MCP Inspector, Claude Desktop) via the SSE endpoint at /sse, using the mcp-remote proxy for local usage.

Key features of Remote MCP Server on Cloudflare

• Runs on Cloudflare Workers for global, serverless deployment.
• Includes OAuth login for secure access.
• Communicates over SSE (Server-Sent Events).
• Supports local development and debugging.
• Integrates with Claude Desktop and MCP Inspector.
• Provides a math tool as an example out of the box.

Use cases of Remote MCP Server on Cloudflare

• Building and hosting a remote MCP server on Cloudflare’s edge network.
• Connecting Claude Desktop to a cloud‑based MCP server via OAuth.
• Testing and debugging MCP tools locally with the MCP Inspector.
• Deploying a secure remote tool server with minimal infrastructure.

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 inspector with npx @modelcontextprotocol/inspector, set Transport Type to SSE, and enter http://localhost:8787/sse (or your deployed URL /sse) as the server URL.

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, then run npm run deploy.

How do I connect Claude Desktop to the remote server?

Add an entry to Claude Desktop’s config file using npx mcp-remote as the command and your server’s /sse URL (e.g., https://worker-name.account-name.workers.dev/sse) as an argument.

What runtime dependencies are required?

Node.js and npm (or npx) are needed for local development and the mcp-remote proxy. Cloudflare Wrangler is used for deployment.