Overview
What is Remote MCP Server on Cloudflare?
This project sets up a remote MCP (Model Context Protocol) server on Cloudflare Workers with OAuth login. It is intended for developers who want to host an MCP server remotely and connect clients like Claude Desktop or the MCP Inspector.
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 such as the MCP Inspector or Claude Desktop by pointing to the SSE endpoint (e.g., http://localhost:8787/sse locally or the workers.dev URL remotely) using the mcp-remote proxy.
Key features of Remote MCP Server on Cloudflare
- OAuth login integration for authentication
- Runs on Cloudflare Workers for serverless deployment
- Uses SSE (Server-Sent Events) transport
- Local development with hot reload
- Compatible with MCP Inspector and Claude Desktop
- Supports deployment to workers.dev
Use cases of Remote MCP Server on Cloudflare
- Hosting a custom MCP tool server for use with Claude Desktop
- Testing MCP tools locally with the MCP Inspector
- Running a remote MCP server accessible from any MCP client
- Demonstrating an OAuth-protected MCP endpoint
FAQ from Remote MCP Server on Cloudflare
How do I run the server locally?
Run npx nx dev remote-mcp-server in the cloned repository and open http://localhost:8787/ in your browser.
How can I connect Claude Desktop to the local server?
Add an entry to Claude Desktop’s configuration file using mcp-remote with the URL http://localhost:8787/sse.
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.
What transport does the server use?
The server uses SSE (Server-Sent Events) at endpoints such as /sse.
How do I debug connection issues?
Try connecting directly with npx mcp-remote http://localhost:8787/sse, restart Claude, or clear ~/.mcp-auth if needed.
