Remote MCP Server on Cloudflare
@pomelo-neko
Overview
What is Remote MCP Server on Cloudflare?
Remote MCP Server on Cloudflare is a template for deploying a remote MCP (Model Context Protocol) server on Cloudflare Workers with OAuth login. It enables developers to run MCP tools remotely and connect them to MCP clients such as 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 using npx nx dev remote-mcp-server. Connect the MCP Inspector by setting its transport to SSE and pointing to http://localhost:8787/sse. For Claude Desktop, configure mcpServers with the mcp-remote command and the server’s SSE URL. Deploy to Cloudflare with npm run deploy after setting up a KV namespace.
Key features of Remote MCP Server on Cloudflare
- Runs as a remote MCP server on Cloudflare Workers
- Includes OAuth login for authentication
- Supports local development with a mock login
- Deploys to a public
workers.devURL - Connects to MCP Inspector and Claude Desktop via SSE
Use cases of Remote MCP Server on Cloudflare
- Hosting MCP tools accessible from any MCP client over the internet
- Testing and debugging MCP servers locally before deploying
- Integrating MCP tools with Claude Desktop using a remote proxy
FAQ from Remote MCP Server on Cloudflare
What runtime and dependencies are needed?
Node.js and npm are required for local development. A Cloudflare account is needed for deployment.
How does authentication work?
The server includes OAuth login. Locally, a mock login screen accepts any email and password. Deployed servers use OAuth with Cloudflare KV for token storage.
How is data stored?
OAuth tokens are stored in a Cloudflare KV namespace defined in wrangler.jsonc.
What transport protocol does the server use?
The server communicates over SSE (Server-Sent Events) at the /sse endpoint.
What are known limitations or debugging tips?
If connection issues occur, restart Claude or try connecting via the command line with npx mcp-remote <url>. Clearing ~/.mcp-auth may resolve persistent authentication problems.
