Remote MCP Server on Cloudflare

What is Remote MCP Server on Cloudflare?

It is a project that lets you run a remote MCP (Model Context Protocol) server on Cloudflare Workers, complete with OAuth login. It is designed for developers who want to deploy and connect MCP tools remotely.

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. To connect, use the MCP Inspector (set Transport Type to SSE and enter http://localhost:8787/sse) or configure Claude Desktop with the mcp-remote command pointing to your server URL. Deploy using npm run deploy after creating a KV namespace for OAuth.

Key features of Remote MCP Server on Cloudflare

• Run a remote MCP server on Cloudflare Workers
• OAuth login for authentication
• Local development with hot reload
• Connect via MCP Inspector or Claude Desktop
• Deploy with a single npm run deploy command
• Debugging with mcp-remote CLI

Use cases of Remote MCP Server on Cloudflare

• Hosting custom MCP tools accessible from anywhere
• Testing MCP tools locally before deploying
• Integrating MCP tools with Claude Desktop remotely
• Using MCP Inspector to explore and invoke tools
• Building serverless MCP endpoints with Cloudflare

FAQ from Remote MCP Server on Cloudflare

What is an MCP server?

An MCP (Model Context Protocol) server exposes tools that AI clients like Claude can discover and call. This project creates such a server on Cloudflare Workers.

How do I deploy my own instance?

Run npx wrangler kv namespace create OAUTH_KV, add the KV namespace ID to wrangler.jsonc, then run npm run deploy. Your server will be available at a workers.dev URL.

How do I connect Claude Desktop?

Update your Claude configuration file to add an MCP server entry using npx mcp-remote as the command and your server’s SSE URL (e.g., https://worker-name.account-name.workers.dev/sse) as the argument.

What transport protocol does the server use?

It uses Server-Sent Events (SSE) – connect to the /sse endpoint.

How can I debug connection issues?

Restart Claude, or try connecting directly via the command line with npx mcp-remote http://localhost:8787/sse. If needed, clear cached auth files with rm -rf ~/.mcp-auth.