Remote MCP Server on Cloudflare

@deloreyj

About Remote MCP Server on Cloudflare

No overview available yet

#remote-mcp-server #cloudflare #mcp-inspector

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "remote-mcp-server-deloreyj": {
      "command": "npx",
      "args": [
        "nx",
        "dev",
        "remote-mcp-server"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Remote MCP Server on Cloudflare?

A template for running a remote MCP (Model Context Protocol) server on Cloudflare Workers, complete with OAuth login. It is intended for developers who want to expose MCP tools over the internet and connect them to AI assistants like Claude Desktop.

How to use Remote MCP Server on Cloudflare?

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

Key features of Remote MCP Server on Cloudflare

Local development with mock OAuth login
One‑command deployment to Cloudflare Workers
OAuth‑protected endpoints for secure access
SSE (Server‑Sent Events) transport for MCP
Compatible with MCP Inspector and Claude Desktop

Use cases of Remote MCP Server on Cloudflare

Hosting custom math, search, or other MCP tools remotely
Connecting Claude Desktop to cloud‑hosted tools via OAuth
Testing MCP server behavior with the MCP Inspector
Building a production‑ready remote MCP server skeleton

FAQ from Remote MCP Server on Cloudflare

How do I test the server locally?

Run npx nx dev remote-mcp-server and open http://localhost:8787/. Use the MCP Inspector with SSE transport at http://localhost:8787/sse and log in with any email/password.

How do I deploy the server to Cloudflare?

Create a KV namespace with npx wrangler kv namespace create OAUTH_KV, add the 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 to the remote server?

Edit the Claude Desktop config file (mcpServers entry) to use npx mcp-remote with the server’s /sse URL (e.g., https://worker-name.account-name.workers.dev/sse). Restart Claude and log in via the browser window.

What dependencies are required?

Node.js, npm, a Cloudflare account, and the wrangler CLI. The local proxy for Claude Desktop uses the mcp-remote npm package.

How can I debug connection issues?

Restart Claude or try connecting directly via npx mcp-remote http://localhost:8787/sse (or the remote URL). If authentication problems persist, clear ~/.mcp-auth with rm -rf ~/.mcp-auth.

Frequently asked questions

How do I test the server locally?

Run `npx nx dev remote-mcp-server` and open `http://localhost:8787/`. Use the MCP Inspector with SSE transport at `http://localhost:8787/sse` and log in with any email/password.

How do I deploy the server to Cloudflare?

Create a KV namespace with `npx wrangler kv namespace create OAUTH_KV`, add the 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 to the remote server?

Edit the Claude Desktop config file (`mcpServers` entry) to use `npx mcp-remote` with the server’s `/sse` URL (e.g., `https://worker-name.account-name.workers.dev/sse`). Restart Claude and log in via the browser window.

What dependencies are required?

Node.js, npm, a Cloudflare account, and the `wrangler` CLI. The local proxy for Claude Desktop uses the `mcp-remote` npm package.

How can I debug connection issues?

Restart Claude or try connecting directly via `npx mcp-remote http://localhost:8787/sse` (or the remote URL). If authentication problems persist, clear `~/.mcp-auth` with `rm -rf ~/.mcp-auth`.