Remote MCP Server on Cloudflare

What is Remote MCP Server on Cloudflare?

It is a project to set up a remote MCP (Model Context Protocol) server on Cloudflare Workers, complete with OAuth login. It is intended for developers who want to run MCP servers remotely and connect MCP clients such as 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 using npx wrangler kv namespace create OAUTH_KV, add the KV namespace ID to wrangler.jsonc, then run npm run deploy. Connect clients like the MCP Inspector or Claude Desktop over SSE using the appropriate URL (e.g., http://localhost:8787/sse locally or https://worker-name.account-name.workers.dev/sse after deployment).

Key features of Remote MCP Server on Cloudflare

• OAuth login for secure client access.
• SSE (Server-Sent Events) transport for MCP communication.
• Deployable to Cloudflare Workers for remote hosting.
• Works with MCP Inspector for testing.
• Integrates with Claude Desktop via a local proxy (mcp-remote).

Use cases of Remote MCP Server on Cloudflare

• Run an MCP server remotely on Cloudflare Workers.
• Connect the MCP Inspector to explore and test tools.
• Use Claude Desktop with a remote MCP server after OAuth login.
• Develop and debug MCP servers locally before deploying.

FAQ from Remote MCP Server on Cloudflare

How do I develop and run the server locally?

Clone the repository, run npx nx dev remote-mcp-server, and open http://localhost:8787/ in a browser.

How do I connect the MCP Inspector to the server?

Start the inspector with npx @modelcontextprotocol/inspector, set Transport Type to SSE, and enter http://localhost:8787/sse (or the deployed URL) as the server URL. Log in with any email and password.

How do I connect Claude Desktop to the remote server?

In Claude Desktop’s config file, add an entry with "command": "npx" and "args": ["mcp-remote", "https://worker-name.account-name.workers.dev/sse"]. Restart Claude.

How do I deploy the server to Cloudflare?

Create a KV namespace with npx wrangler kv namespace create OAUTH_KV, update wrangler.jsonc with the namespace ID, then run npm run deploy.

What should I do if something goes wrong?

Try restarting Claude, or test the connection directly with npx mcp-remote http://localhost:8787/sse. In rare cases, clear ~/.mcp-auth with rm -rf ~/.mcp-auth.