Remote MCP Server on Cloudflare

@aYenx

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-ayenx": {
      "command": "npx",
      "args": [
        "nx",
        "dev",
        "remote-mcp-server"
      ]
    }
  }
}

Tools

No tools detected

Fetch the live tool list by running this server in a temporary sandbox using the button above.

Overview

What is Remote MCP Server on Cloudflare?

A reference implementation for deploying a remote MCP (Model Context Protocol) server on Cloudflare Workers with OAuth login. It provides an SSE‑based endpoint that remote MCP clients (like Claude Desktop or the MCP Inspector) can connect to over the internet.

How to use Remote MCP Server on Cloudflare?

Clone the repository from github.com/cloudflare/ai, install dependencies with npm install, and run locally with npx nx dev remote-mcp-server. To deploy, create a KV namespace (npx wrangler kv namespace create OAUTH_KV) and run npm run deploy. Connect clients by pointing them to the Worker’s /sse URL (e.g., https://worker-name.account-name.workers.dev/sse).

Key features of Remote MCP Server on Cloudflare

Runs on Cloudflare Workers with OAuth authentication.
Uses SSE (Server‑Sent Events) transport.
Supports local development and remote deployment.
Integrates with MCP Inspector and Claude Desktop.
Includes a mock login screen for testing.

Use cases of Remote MCP Server on Cloudflare

Hosting a remote MCP tool server behind OAuth authentication.
Connecting Claude Desktop to a cloud‑deployed MCP server.
Prototyping and testing MCP servers with the MCP Inspector.
Running a math‑tool MCP server as a reference example.

FAQ from Remote MCP Server on Cloudflare

How do I run the server locally?

Clone the repo, npm install, then npx nx dev remote-mcp-server. The server will be available at http://localhost:8787/.

How do I connect Claude Desktop to the deployed server?

In Claude Desktop settings, add an MCP server entry with command npx mcp-remote and arguments pointing to the Worker’s /sse URL (e.g., https://worker-name.account-name.workers.dev/sse).

What transport does the server use?

It uses SSE (Server‑Sent Events) — set Transport Type to SSE and connect to the /sse path.

How do I debug connectivity issues?

Restart Claude, or test directly with npx mcp-remote http://localhost:8787/sse. If needed, clear cached auth files with rm -rf ~/.mcp-auth.

Frequently asked questions

How do I run the server locally?

Clone the repo, `npm install`, then `npx nx dev remote-mcp-server`. The server will be available at `http://localhost:8787/`.

How do I connect Claude Desktop to the deployed server?

In Claude Desktop settings, add an MCP server entry with command `npx mcp-remote` and arguments pointing to the Worker’s `/sse` URL (e.g., `https://worker-name.account-name.workers.dev/sse`).