Remote MCP Server on Cloudflare

What is Remote MCP Server on Cloudflare?

Remote MCP Server on Cloudflare is a project to set up an MCP (Model Context Protocol) server on Cloudflare Workers with OAuth login. It provides a template for developers to create, test locally, and deploy a remote MCP server that supports SSE transport and authentication.

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 by creating a KV namespace (npx wrangler kv namespace create OAUTH_KV), adding the namespace ID to wrangler.jsonc, and running npm run deploy. Connect clients such as the MCP Inspector or Claude Desktop by pointing them to the SSE endpoint (e.g., http://localhost:8787/sse locally or https://worker-name.account-name.workers.dev/sse remote).

Key features of Remote MCP Server on Cloudflare

• Complete OAuth login flow for authentication
• Local development with hot reload (npx nx dev)
• Deployable to Cloudflare Workers with one command
• Uses SSE (Server-Sent Events) transport for MCP
• Integrates with MCP Inspector for testing
• Works with Claude Desktop via mcp-remote proxy

Use cases of Remote MCP Server on Cloudflare

• Deploy a remote MCP server with user authentication for AI assistants
• Test MCP tools locally using the MCP Inspector with SSE transport
• Connect Claude Desktop to a local or remote MCP server for tool calling
• Implement custom MCP tools behind OAuth on Cloudflare’s edge network

FAQ from Remote MCP Server on Cloudflare

How do I run the server locally?

Clone the repository, run npm install, then start with npx nx dev remote-mcp-server and open http://localhost:8787/.

How do I connect the MCP Inspector to my server?

Start the inspector with npx @modelcontextprotocol/inspector, switch transport to SSE, and enter the server’s SSE URL (e.g., http://localhost:8787/sse). Log in with any email and password on the mock login screen.

How do I deploy to Cloudflare?

Create a KV namespace with npx wrangler kv namespace create OAUTH_KV, add its ID to wrangler.jsonc, then run npm run deploy. The server will be available at your workers.dev URL.

How do I connect Claude Desktop to the server?

Edit Claude’s configuration file (Settings > Developer > Edit Config) and add an entry using mcp-remote with the SSE URL (e.g., http://localhost:8787/sse locally or the deployed URL). A browser window will open for OAuth login.

How do I debug connection issues?

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