Remote MCP Server on Cloudflare

What is Remote MCP Server on Cloudflare?

This server lets you run a remote MCP (Model Context Protocol) server on Cloudflare Workers with OAuth login. It is designed for developers who want to host and access MCP endpoints over HTTP/SSE, enabling integration with tools like the MCP Inspector or Claude Desktop.

How to use Remote MCP Server on Cloudflare?

Clone the repository, install dependencies with npm install, and run locally with npx nx dev remote-mcp-server. Deploy to Cloudflare using npx wrangler kv namespace create OAUTH_KV and npm run deploy. Connect via the MCP Inspector using SSE at the server’s /sse URL, or configure Claude Desktop to point to that endpoint with the mcp-remote proxy.

Key features of Remote MCP Server on Cloudflare

• Runs on Cloudflare Workers with full global deployment.
• Includes OAuth login for secure access.
• Supports SSE (Server-Sent Events) transport.
• Works with MCP Inspector for local testing.
• Connects directly to Claude Desktop via a local proxy.
• Example math tool included (addition of two numbers).

Use cases of Remote MCP Server on Cloudflare

• Deploy a custom MCP server that clients can call from anywhere.
• Grant Claude Desktop the ability to invoke tools hosted on Cloudflare.
• Rapidly prototype and test MCP tools using the inspector.
• Provide a remote tool endpoint behind OAuth for team usage.

FAQ from Remote MCP Server on Cloudflare

What transport protocol does the server use?

The server uses SSE (Server-Sent Events) over HTTP. Clients connect to its /sse endpoint.

How do I authenticate with the server?

Authentication is handled via OAuth. When connecting, a browser window opens where you can log in with any email and password (mock during local development).

What tools are included by default?

The example server includes a math tool called add that takes two numbers and returns their sum.

How can I deploy the server to Cloudflare?

Run npx wrangler kv namespace create OAUTH_KV, add the KV namespace ID to wrangler.jsonc, then run npm run deploy. The server will be available at your workers.dev URL.

How do I debug connection issues?

Restart Claude, or test connection directly via npx mcp-remote <URL>. If problems persist, clear the local auth files with rm -rf ~/.mcp-auth.