Remote MCP Server on Cloudflare

What is Remote MCP Server on Cloudflare?

This server lets you run a remote Model Context Protocol (MCP) server on Cloudflare Workers with OAuth login, enabling tools to be called over HTTP SSE from clients like the MCP Inspector or Claude Desktop.

How to use Remote MCP Server on Cloudflare?

Clone the repo, install dependencies via npm, then run locally with npx nx dev remote-mcp-server. For deployment, use npx wrangler kv namespace create OAUTH_KV, add the KV namespace ID to wrangler.jsonc, then run npm run deploy.

Key features of Remote MCP Server on Cloudflare

• Local development with live reload
• OAuth login flow (mock for local testing)
• SSE (Server-Sent Events) transport
• Deploy to Cloudflare Workers via Wrangler
• Compatible with MCP Inspector and Claude Desktop

Use cases of Remote MCP Server on Cloudflare

• Deploy a remotely accessible MCP server for AI assistants
• Test MCP tools locally using the MCP Inspector
• Integrate custom tools with Claude Desktop over the internet

FAQ from Remote MCP Server on Cloudflare

What transport protocol does this server use?

It uses SSE (Server-Sent Events) over HTTP.

How do I connect Claude Desktop to the server?

Configure Claude Desktop’s config file with the mcp-remote command and the server’s SSE endpoint (e.g., http://localhost:8787/sse locally, or https://worker-name.account-name.workers.dev/sse after deployment).

What authentication is used?

The server implements OAuth login. For local development, a mock login screen accepts any email and password. After deployment, the OAuth flow uses Cloudflare Workers authentication.

What are the runtime dependencies?

Node.js, npm, and for deployment: wrangler CLI and a Cloudflare KV namespace.

How can I debug connection issues?

Restart Claude, try connecting via npx mcp-remote http://localhost:8787/sse on the command line, or clear credentials stored in ~/.mcp-auth by running rm -rf ~/.mcp-auth.