Remote MCP Server on Cloudflare

What is Remote MCP Server on Cloudflare?

A guide to get a remote MCP server up-and-running on Cloudflare Workers complete with OAuth login, designed for developers who want to host and connect MCP tools remotely.

How to use Remote MCP Server on Cloudflare?

Clone the repository, install dependencies, and run locally with npx nx dev remote-mcp-server. Deploy to Cloudflare by creating an OAUTH_KV namespace with npx wrangler kv namespace create OAUTH_KV, adding the namespace ID to wrangler.jsonc, then running npm run deploy. Connect clients via the MCP Inspector at the /sse endpoint or configure Claude Desktop with a mcp-remote proxy.

Key features of Remote MCP Server on Cloudflare

• Hosts MCP servers on Cloudflare Workers
• Includes OAuth login for authentication
• Uses SSE (Server-Sent Events) transport
• Works with MCP Inspector for testing
• Connects to Claude Desktop via mcp-remote proxy
• Deployable to a workers.dev subdomain

Use cases of Remote MCP Server on Cloudflare

• Running a remote MCP server with OAuth-based authentication
• Connecting Claude Desktop to remote MCP tools via SSE
• Developing and testing MCP servers locally before deploying to Cloudflare

FAQ from Remote MCP Server on Cloudflare

What does this project do?

It provides a complete setup to run a remote MCP server on Cloudflare Workers with OAuth login, including local development, deployment, and client connection instructions.

How do I deploy the server to Cloudflare?

Create an OAUTH_KV namespace with npx wrangler kv namespace create OAUTH_KV, add the namespace ID to wrangler.jsonc, and run npm run deploy.

How do I connect Claude Desktop to the remote server?

Update Claude Desktop's config file to use npx mcp-remote with the Workers SSE URL (e.g., https://worker-name.account-name.workers.dev/sse) and restart Claude.

How do I test the server locally?

Run npx nx dev remote-mcp-server, then use the MCP Inspector at http://localhost:8787/sse to connect and test tools.

What if something goes wrong?

Restart Claude, try connecting directly with npx mcp-remote http://localhost:8787/sse, or clear the auth files in ~/.mcp-auth with rm -rf ~/.mcp-auth.