Remote MCP Server on Cloudflare

What is Remote MCP Server on Cloudflare?

A template for deploying a remote MCP (Model Context Protocol) server on Cloudflare Workers with OAuth login, enabling secure tool invocation from MCP clients like the MCP Inspector or Claude Desktop.

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 using npm run deploy after setting up a KV namespace (npx wrangler kv namespace create OAUTH_KV). Connect MCP clients by pointing them to the SSE endpoint (e.g., http://localhost:8787/sse locally or the Workers URL).

Key features of Remote MCP Server on Cloudflare

• Runs as a Cloudflare Worker with OAuth authentication.
• Uses SSE (Server-Sent Events) transport for MCP communication.
• Supports local development with mock login.
• Deployable to a public workers.dev URL.
• Compatible with MCP Inspector and Claude Desktop via mcp-remote proxy.
• Includes a built‑in math tool as an example.

Use cases of Remote MCP Server on Cloudflare

• Hosting custom MCP tools accessible from any MCP client anywhere.
• Prototyping and testing MCP servers locally before deploying globally.
• Integrating cloud‑hosted tools with Claude Desktop using OAuth login.
• Demonstrating a complete MCP deployment pipeline from local to production.

FAQ from Remote MCP Server on Cloudflare

What dependencies are required to run this server?

You need Node.js, npm, and the Cloudflare Wrangler CLI (npx wrangler). The project uses nx for monorepo orchestration.

How do I deploy the server to Cloudflare?

Run npx wrangler kv namespace create OAUTH_KV, add the returned ID to wrangler.jsonc, then run npm run deploy.

How can I test the MCP server locally?

Start the development server with npx nx dev remote-mcp-server, then connect using the MCP Inspector (npx @modelcontextprotocol/inspector) with URL http://localhost:8787/sse and SSE transport.

How do I connect Claude Desktop to the remote server?

Update Claude’s config file to use mcp-remote with the Workers URL (e.g., https://worker-name.account-name.workers.dev/sse). Restart Claude; a browser will open for OAuth login.

How can I clear authentication issues?

If login problems persist, clear the cached auth files with rm -rf ~/.mcp-auth.