Remote MCP Server on Cloudflare

What is Remote MCP Server on Cloudflare?

Remote MCP Server on Cloudflare is a starter template that lets developers run a Model Context Protocol (MCP) server on Cloudflare Workers, complete with OAuth login. It enables AI assistants like Claude Desktop to connect to and call MCP tools hosted remotely on Cloudflare’s edge network.

How to use Remote MCP Server on Cloudflare?

Clone the repository, install dependencies, and run locally with npx nx dev remote-mcp-server. Use the MCP Inspector (with SSE transport) or configure Claude Desktop via the mcp-remote proxy pointing to the server’s /sse endpoint. Deploy to Cloudflare with npm run deploy after creating a KV namespace for OAuth state.

Key features of Remote MCP Server on Cloudflare

• Runs as a Cloudflare Worker with server‑sent events (SSE) transport
• Includes OAuth login for authenticated access
• Local development with hot‑reload and MCP Inspector support
• Connects Claude Desktop via a lightweight local proxy (mcp-remote)
• Example math tool demonstrates tool listing and calling
• Deploys to a public workers.dev URL

Use cases of Remote MCP Server on Cloudflare

• Host a remote MCP server for multiple AI assistant clients
• Add custom, edge‑deployed tools to Claude Desktop
• Prototype and test MCP servers locally before global deployment
• Provide authenticated tool access via OAuth on Cloudflare’s network

FAQ from Remote MCP Server on Cloudflare

What transport protocol does the server use?

It uses SSE (Server‑Sent Events) over HTTP. Clients connect to the /sse endpoint.

How do I connect Claude Desktop to this server?

Add an mcpServers entry in Claude Desktop’s config that runs npx mcp-remote <server‑url>/sse as a command with args pointing to the remote or local SSE URL.

Can I run the server locally before deploying?

Yes. Run npx nx dev remote-mcp-server and access http://localhost:8787/. Use the MCP Inspector or Claude Desktop’s local proxy to test tools.

How do I deploy to Cloudflare?

First create a KV namespace with npx wrangler kv namespace create OAUTH_KV and add its ID to wrangler.jsonc. Then run npm run deploy.

Does the server enforce authentication?

Yes, it includes an OAuth login flow. When connecting from a client (Inspector or Claude Desktop), a browser window opens for user/password authentication.