Remote MCP Server on Cloudflare

What is Remote MCP Server on Cloudflare?

A guide and starter project to deploy a remote Model Context Protocol (MCP) server on Cloudflare Workers with OAuth login, enabling clients like Claude Desktop to call tools over the internet.

How to use Remote MCP Server on Cloudflare?

Clone the repository, install dependencies, and run locally with npx nx dev remote-mcp-server. Deploy using npx wrangler kv namespace create OAUTH_KV and npm run deploy. Connect clients via the MCP Inspector (SSE transport) or Claude Desktop using the mcp-remote proxy pointed to the server’s /sse endpoint.

Key features of Remote MCP Server on Cloudflare

• Deploy MCP server as a Cloudflare Worker
• OAuth login for secure tool access
• SSE-based transport for remote connections
• Local development with hot reload via Nx
• Ready integration with MCP Inspector and Claude Desktop

Use cases of Remote MCP Server on Cloudflare

• Host a math tool server accessible from any MCP client
• Connect Claude Desktop to remote MCP tools over the internet
• Develop and test MCP servers locally before deploying
• Provide external teams with OAuth-protected MCP endpoints

FAQ from Remote MCP Server on Cloudflare

How do I connect Claude Desktop to the remote server?

Update your Claude configuration to use mcp-remote with the server’s workers.dev URL (e.g., https://worker-name.account-name.workers.dev/sse). Restart Claude – a browser window will open for OAuth login.

What transport type is used?

The server uses Server-Sent Events (SSE). When connecting via MCP Inspector, set Transport Type to SSE and enter the server URL followed by /sse.

What are the deployment steps?

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 a workers.dev URL.

How do I debug connection issues?

Restart Claude or try connecting directly from the command line with npx mcp-remote http://localhost:8787/sse. Rarely, clear the auth cache with rm -rf ~/.mcp-auth.

What runtime dependencies are required?

Node.js, npm, a Cloudflare account, and the Cloudflare Workers CLI (wrangler). The project uses Nx for local development and mcp-remote for client proxying.