Remote MCP Server on Cloudflare

What is Remote MCP Server on Cloudflare?

Remote MCP Server on Cloudflare is a starter project that sets up a Model Context Protocol (MCP) server running on Cloudflare Workers, complete with OAuth login. It is intended for developers who want to deploy a remote MCP endpoint accessible over the internet.

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. Open http://localhost:8787/ in a browser. Use the MCP Inspector with SSE transport at http://localhost:8787/sse to test tools. To connect Claude Desktop, add a configuration entry using npx mcp-remote with the local or deployed URL. Deploy to Cloudflare with npm run deploy after creating an OAUTH_KV namespace with npx wrangler kv namespace create OAUTH_KV.

Key features of Remote MCP Server on Cloudflare

• Runs on Cloudflare Workers for global, serverless deployment.
• Includes OAuth login for authentication.
• Uses SSE (Server‑Sent Events) transport for MCP communication.
• Supports local development with a mock login screen.
• Works with MCP Inspector and Claude Desktop via a remote proxy.

Use cases of Remote MCP Server on Cloudflare

• Deploy a remote MCP tool server that requires user authentication.
• Prototype and test MCP tools locally before deploying to production.
• Connect Claude Desktop to a custom remote MCP server for advanced tool execution.

FAQ from Remote MCP Server on Cloudflare

How do I connect the MCP Inspector to my server?

Open the Inspector, set Transport Type to SSE, enter http://localhost:8787/sse (or your deployed URL) as the server URL, and click Connect. A mock login screen appears – enter any email and password to log in.

How do I connect Claude Desktop to the server?

Edit Claude Desktop’s configuration file and add an entry with command npx and arguments ["mcp-remote", "http://localhost:8787/sse"] (or your remote URL). Restart Claude; a browser window will open for OAuth login.

What runtime dependencies does the server require?

Node.js and npm are needed for local development. For deployment, the Cloudflare Workers runtime and the wrangler CLI are used. The server stores OAuth data in Cloudflare KV (OAUTH_KV).

How can I debug connection issues?

Restart Claude or test the MCP server directly from the command line using npx mcp-remote http://localhost:8787/sse. If problems persist, clear cached authentication files with rm -rf ~/.mcp-auth.

What transport and authentication does the server support?

The server uses SSE (Server‑Sent Events) as the transport protocol. Authentication is handled via OAuth with a login screen (a mock screen locally and a real OAuth flow when deployed).