Remote MCP Server on Cloudflare

What is Remote MCP Server on Cloudflare?

A server that runs on Cloudflare Workers to provide a remote MCP (Model Context Protocol) endpoint with OAuth login. Designed for developers who want to expose MCP tools (e.g., math functions) to remote clients like Claude Desktop.

How to use Remote MCP Server on Cloudflare?

Clone the repository, install dependencies (npm install), and run locally with npx nx dev remote-mcp-server. Deploy to Cloudflare using npm run deploy after setting up a KV namespace. Connect clients via the MCP Inspector (SSE transport) or Claude Desktop by configuring mcpServers in Claude’s config file with the local or remote /sse URL.

Key features of Remote MCP Server on Cloudflare

• OAuth login for secure access
• SSE transport for MCP communication
• Local development and Cloudflare Workers deployment
• Works with MCP Inspector and Claude Desktop
• Supports custom tools (e.g., math operations)
• Includes a local proxy (mcp-remote) for Claude

Use cases of Remote MCP Server on Cloudflare

• Expose a math tool to Claude Desktop for remote calculation
• Test MCP tools locally with the MCP Inspector
• Deploy a production MCP server on Cloudflare’s edge network
• Provide OAuth‑protected MCP endpoints for custom clients

FAQ from Remote MCP Server on Cloudflare

How do I develop the server locally?

Clone the repository, run npm install, then execute npx nx dev remote-mcp-server and open http://localhost:8787/ in your browser.

How can I test the server with MCP Inspector?

Start the inspector with npx @modelcontextprotocol/inspector, set Transport Type to SSE and URL to http://localhost:8787/sse, then click Connect. A mock login screen appears; enter any email and password.

How do I connect Claude Desktop to my local server?

Edit Claude Desktop’s config file (Settings > Developer > Edit Config) and add an MCP server with command npx and args ["mcp-remote", "http://localhost:8787/sse"]. Restart Claude to see available tools.

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. Your server will be available at a workers.dev URL.

What should I do if something goes wrong?

Restart Claude, or test the MCP server directly with npx mcp-remote http://localhost:8787/sse. In rare cases, clear cached auth files with rm -rf ~/.mcp-auth.