概览
What is Remote MCP Server on Cloudflare?
Remote MCP Server on Cloudflare is a starter kit for running a remote Model Context Protocol (MCP) server on Cloudflare Workers with OAuth login. It is designed for developers who want to host an MCP server that can be accessed remotely and integrated with clients like Claude Desktop.
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. Deploy to Cloudflare Workers by creating a KV namespace for OAuth with npx wrangler kv namespace create OAUTH_KV, adding the namespace ID to wrangler.jsonc, and running npm run deploy. Connect clients via SSE at the /sse endpoint.
Key features of Remote MCP Server on Cloudflare
- Deploy a remote MCP server on Cloudflare Workers.
- Built-in OAuth login flow.
- Local development with hot-reload.
- Connect via MCP Inspector or Claude Desktop.
- Simple deployment with Wrangler CLI.
Use cases of Remote MCP Server on Cloudflare
- Hosting a math or utility tool for AI clients like Claude.
- Creating a remote MCP server accessible over the internet.
- Prototyping MCP servers with Cloudflare’s global edge network.
- Integrating OAuth-protected MCP tools with desktop assistants.
FAQ from Remote MCP Server on Cloudflare
How do I develop locally?
Clone the repository, run npm install in the ai directory, then execute npx nx dev remote-mcp-server. The server will be available at http://localhost:8787/.
How do I connect the MCP Inspector to my local server?
Start the MCP Inspector with npx @modelcontextprotocol/inspector, set Transport Type to SSE, enter http://localhost:8787/sse as the server URL, and click “Connect”. You can then log in with any email and password.
How do I deploy the server to Cloudflare Workers?
Create a KV namespace with npx wrangler kv namespace create OAUTH_KV, add the namespace ID to wrangler.jsonc, and run npm run deploy. The server will be available at a workers.dev URL.
How do I connect Claude Desktop to the remote server?
Update Claude Desktop’s configuration file (Settings > Developer > Edit Config) with a mcpServers entry using mcp-remote as the command and the server’s /sse URL (e.g., https://worker-name.account-name.workers.dev/sse) as the argument.
What debugging steps are available?
Restart Claude Desktop, try connecting directly via npx mcp-remote http://localhost:8787/sse, or clear cached authentication files with rm -rf ~/.mcp-auth.
