Remote MCP Server on Cloudflare
@SzczepanBEN
Overview
What is Remote MCP Server on Cloudflare?
Remote MCP Server on Cloudflare helps you quickly deploy a remote MCP server on Cloudflare Workers with built-in OAuth login. It is intended for developers who want to expose Model Context Protocol (MCP) tools—like a math tool—over HTTP/S using SSE transport.
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. To deploy, create a KV namespace with npx wrangler kv namespace create OAUTH_KV, add its ID to wrangler.jsonc, then run npm run deploy. Connect clients by pointing an MCP inspector or Claude Desktop (via the mcp-remote proxy) to the server’s /sse endpoint.
Key features of Remote MCP Server on Cloudflare
- Deploy as a Cloudflare Worker
- OAuth login for secure access
- SSE transport for MCP communication
- Easy local development with Nx
- Pre‑defined tools (e.g., math tool)
Use cases of Remote MCP Server on Cloudflare
- Let Claude Desktop call custom MCP tools remotely
- Prototype MCP servers with minimal infrastructure
- Share MCP tools across devices via a public URL
- Authenticate users with OAuth before tool access
FAQ from Remote MCP Server on Cloudflare
How do I run the server locally?
Clone the repo, run npm install, then execute npx nx dev remote-mcp-server. The server will be available at http://localhost:8787/.
How do I deploy to Cloudflare?
Create a KV namespace with npx wrangler kv namespace create OAUTH_KV, add the ID to wrangler.jsonc, then run npm run deploy. The server will be live at a workers.dev URL.
How do I connect Claude Desktop?
Add a configuration entry in Claude Desktop’s config file that uses npx mcp-remote with the server’s /sse URL (e.g., https://worker-name.account-name.workers.dev/sse).
How do I test with the MCP Inspector?
Start the inspector with npx @modelcontextprotocol/inspector, switch transport to SSE, enter the server URL plus /sse, and click Connect. A mock login screen will appear; input any email and password.
What transport protocol does the server use?
The server uses Server‑Sent Events (SSE) for MCP communication, as shown in the inspector’s “Transport Type” setting.
