概要
What is Remote MCP Server on Cloudflare?
Remote MCP Server on Cloudflare is a project to deploy a remote Model Context Protocol (MCP) server on Cloudflare Workers, complete with OAuth login. It enables developers to run MCP tools on a serverless platform and connect them to MCP clients such as Claude Desktop.
How to use Remote MCP Server on Cloudflare?
Clone the repository, install dependencies with npm install, then run locally with npx nx dev remote-mcp-server. Use the MCP Inspector (npx @modelcontextprotocol/inspector) with SSE transport at http://localhost:8787/sse to test. For deployment, run npx wrangler kv namespace create OAUTH_KV, add the KV namespace ID to wrangler.jsonc, then execute npm run deploy. Connect Claude Desktop by adding an MCP server entry pointing to https://your-worker-url/sse via the mcp-remote proxy.
Key features of Remote MCP Server on Cloudflare
- Deploy a remote MCP server on Cloudflare Workers
- Integrated OAuth login for authentication
- Local development with live reload via
nx dev - Uses SSE (Server-Sent Events) transport
- Works with MCP Inspector for testing tools
- Supports connection to Claude Desktop
Use cases of Remote MCP Server on Cloudflare
- Run MCP tools on a serverless, globally distributed platform
- Enable Claude Desktop to call remote MCP tools securely
- Develop and test MCP tools locally before deploying to production
- Provide authenticated, remote access to custom MCP tools
FAQ from Remote MCP Server on Cloudflare
What transport does the server use?
The server uses SSE (Server-Sent Events) transport; clients connect to /sse endpoint.
How do I deploy the server to Cloudflare?
Run npx wrangler kv namespace create OAUTH_KV, add the returned KV namespace ID to wrangler.jsonc, then run npm run deploy.
How do I connect Claude Desktop to the remote server?
Add a JSON entry to Claude Desktop’s MCP configuration with "command": "npx" and "args": ["mcp-remote", "https://your-worker-url/sse"].
How can I debug connection issues?
Restart Claude, test connectivity directly with npx mcp-remote http://localhost:8787/sse, or clear local auth files with rm -rf ~/.mcp-auth.
Does the server require real OAuth credentials for local development?
No; when running locally, the MCP Inspector shows a mock login screen that accepts any email and password.
