Remote MCP Server on Cloudflare

Name: Remote MCP Server on Cloudflare
Author: xuyuanzhang1122

@xuyuanzhang1122

Repository

About Remote MCP Server on Cloudflare

No overview available yet

Basic information

Config

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

{
  "mcpServers": {
    "remote-mcp-server-xuyuanzhang1122": {
      "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 reference implementation for running a remote Model Context Protocol (MCP) server on Cloudflare Workers, complete with OAuth login. It is intended for developers who want to host MCP tools remotely and connect clients like 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. Connect the MCP Inspector by switching transport type to SSE and entering http://localhost:8787/sse. For Claude Desktop, configure it to use the mcp-remote proxy pointing to the same SSE endpoint. Deploy to Cloudflare using npm run deploy after setting up a KV namespace.

Key features of Remote MCP Server on Cloudflare

Runs on Cloudflare Workers with OAuth login
Uses SSE (Server-Sent Events) transport
Integrates with MCP Inspector for testing
Connects to Claude Desktop via a local proxy
Supports local development and remote deployment

Use cases of Remote MCP Server on Cloudflare

Hosting custom MCP tools on the edge with Cloudflare
Building and testing remote MCP servers locally before deploying
Enabling Claude Desktop to invoke tools from a remote server
Demonstrating OAuth-based authentication for MCP servers

FAQ from Remote MCP Server on Cloudflare

How do I run the server locally?

Clone the repo, run npm install, then npx nx dev remote-mcp-server. Open http://localhost:8787/ in a browser.

How do I connect the MCP Inspector?

Start the inspector with npx @modelcontextprotocol/inspector, switch transport type to SSE, and enter http://localhost:8787/sse as the URL. You will be prompted to log in.

How do I connect Claude Desktop to my server?

Edit Claude Desktop’s config file to add an MCP server entry with command npx, args ["mcp-remote", "http://localhost:8787/sse"] (or the remote URL after deployment). Restart Claude.

How do I deploy to Cloudflare?

Create a KV namespace with npx wrangler kv namespace create OAUTH_KV, add its ID to wrangler.jsonc, then run npm run deploy.

How do I debug connection issues?

Try npx mcp-remote http://localhost:8787/sse directly. In rare cases, clear ~/.mcp-auth with rm -rf ~/.mcp-auth and restart Claude.

Comments

More Cloud & Infrastructure MCP servers

MCP Gateway

mcp-ecosystem

🧩 MCP Gateway - A lightweight gateway service that instantly transforms existing MCP Servers and APIs into MCP servers with zero code changes. Features Docker deployment and management UI, requiring no infrastructure modifications.

2.2K

Query | MCP server for Supabase

alexander-zuev

Query MCP enables end-to-end management of Supabase via chat interface: read & write query executions, management API support, automatic migration versioning, access to logs and much more.

828