Remote MCP Server on Cloudflare

@irvinebroque

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-f": {
      "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 starter project to set up a remote MCP server on Cloudflare Workers with OAuth login. It provides a complete workflow for developing locally, deploying to Cloudflare, and connecting MCP clients like the MCP Inspector or Claude Desktop.

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. Deploy to Cloudflare Workers using npm run deploy after creating a KV namespace for OAuth. Connect clients via SSE by pointing them to the /sse endpoint, using npx mcp-remote for Claude Desktop.

Key features of Remote MCP Server on Cloudflare

Runs on Cloudflare Workers with OAuth login
Uses SSE transport for MCP communication
Includes local development and deployment scripts
Integrates with MCP Inspector for testing
Connects to Claude Desktop via proxy client

Use cases of Remote MCP Server on Cloudflare

Deploying a remote MCP server accessible over the internet
Testing MCP tools locally before deployment
Connecting Claude Desktop to custom MCP tools with OAuth
Building and iterating on MCP tool definitions

FAQ from Remote MCP Server on Cloudflare

What do I need to run the server locally?

You need Node.js and npm. Clone the repository, install dependencies, then run npx nx dev remote-mcp-server and open http://localhost:8787/.

How do I deploy the server to Cloudflare?

Run npx wrangler@latest kv namespace create remote-mcp-server-oauth-kv, add the KV namespace ID to wrangler.jsonc, then execute npm run deploy.

How can I connect Claude Desktop to my remote server?

Update Claude's config file to use npx mcp-remote with your Workers URL (e.g., https://worker-name.account-name.workers.dev/sse). Restart Claude and a browser login window will appear.

What transport does the MCP server use?

The server uses SSE (Server-Sent Events) as the transport type. Clients connect to the /sse endpoint.

How can I debug connection issues?

Run npx mcp-remote http://localhost:8787/sse directly on the command line. In rare cases, clear the OAuth files with rm -rf ~/.mcp-auth.

Frequently asked questions

What do I need to run the server locally?

You need Node.js and npm. Clone the repository, install dependencies, then run `npx nx dev remote-mcp-server` and open `http://localhost:8787/`.

How do I deploy the server to Cloudflare?

Run `npx wrangler@latest kv namespace create remote-mcp-server-oauth-kv`, add the KV namespace ID to `wrangler.jsonc`, then execute `npm run deploy`.

How can I connect Claude Desktop to my remote server?

Update Claude's config file to use `npx mcp-remote` with your Workers URL (e.g., `https://worker-name.account-name.workers.dev/sse`). Restart Claude and a browser login window will appear.