Remote MCP Server on Cloudflare

What is Remote MCP Server on Cloudflare?

Remote MCP Server on Cloudflare is a template to deploy a Model Context Protocol (MCP) server on Cloudflare Workers with OAuth login. It enables AI clients like Claude Desktop to securely call tools over the internet via SSE transport.

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. For remote use, deploy with npm run deploy after creating a KV namespace (npx wrangler kv namespace create OAUTH_KV). Connect clients using the MCP Inspector with SSE transport or via Claude Desktop using the mcp-remote proxy pointing to the server URL.

Key features of Remote MCP Server on Cloudflare

• Runs MCP server on Cloudflare Workers with OAuth login
• Uses SSE (Server-Sent Events) transport for real-time communication
• Supports local development with live reload
• Enables remote tool calling from any MCP client
• Includes built-in OAuth authentication flow
• Integrates with Claude Desktop via mcp-remote proxy
• Offers MCP Inspector support for testing and debugging

Use cases of Remote MCP Server on Cloudflare

• Expose an MCP server publicly so AI assistants can call tools from anywhere
• Add OAuth-secured remote tool access to Claude Desktop
• Deploy an MCP server on Cloudflare’s global edge network
• Develop and test MCP tools locally before deploying to production

FAQ from Remote MCP Server on Cloudflare

What prerequisites are needed to run this server?

You need Node.js and npm installed, a Cloudflare account with wrangler CLI, and optionally the MCP Inspector for testing. For remote deployment, you must create a KV namespace and add its ID to wrangler.jsonc.

How do I connect Claude Desktop to the server?

Update Claude’s configuration file with the mcp-remote command pointing to your server’s SSE endpoint (e.g., https://worker-name.account-name.workers.dev/sse). A browser window will open for OAuth login, and the tools become available in Claude.

How do I deploy the server to Cloudflare?

Run npx wrangler kv namespace create OAUTH_KV to create a KV store, add the namespace ID to wrangler.jsonc, then execute npm run deploy. The server will be available at your Workers URL.

What transport protocol does the server use?

It uses SSE (Server-Sent Events) for the MCP transport. Local clients connect to the /sse endpoint, and remote clients connect via mcp-remote proxy which translates HTTP to the MCP protocol.

How does authentication work?

During local development, a mock login screen accepts any email/password. After deployment, the server uses OAuth for authentication, requiring a browser-based login before clients can call tools. Credentials are cached in ~/.mcp-auth and can be cleared with rm -rf ~/.mcp-auth.