Remote MCP Server on Cloudflare

Name: Remote MCP Server on Cloudflare
Author: Humboldtian

@Humboldtian

Repository

About Remote MCP Server on Cloudflare

No overview available yet

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

Basic information

Config

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

{
  "mcpServers": {
    "remote-mcp-server-humboldtian": {
      "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?

This project provides a remote MCP server running 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 clients like 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. For deployment, create a KV namespace with npx wrangler kv namespace create OAUTH_KV, add the ID to wrangler.jsonc, then run npm run deploy. Connect any MCP client (e.g., the MCP Inspector or Claude Desktop) to the SSE endpoint at /sse.

Key features of Remote MCP Server on Cloudflare

Local development with SSE transport.
OAuth login flow (mock user/password during development).
Deploy to Cloudflare Workers.
Connect via MCP Inspector.
Connect Claude Desktop using mcp-remote proxy.
Debugging support via command‑line connection and credential clearing.

Use cases of Remote MCP Server on Cloudflare

Run an MCP server locally for testing and development.
Deploy a publicly accessible remote MCP server on Cloudflare.
Connect Claude Desktop to a remote MCP server with OAuth authentication.
Test MCP tool calls using the MCP Inspector.

FAQ from Remote MCP Server on Cloudflare

How do I develop locally?

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

How do I connect the MCP Inspector to my local server?

Start the inspector with npx @modelcontextprotocol/inspector, switch Transport Type to SSE, and enter http://localhost:8787/sse as the URL. Log in with any email and password on the mock login screen.

How do I deploy to Cloudflare?

First create a KV namespace with npx wrangler kv namespace create OAUTH_KV and add its ID to wrangler.jsonc. Then run npm run deploy.

How do I connect Claude Desktop to a remote server?

Update your Claude Desktop config file to use mcp-remote with the full workers.dev URL (e.g., https://worker-name.account-name.workers.dev/sse). Restart Claude; a browser window will open for OAuth login.

What should I do if something goes wrong?

Try restarting Claude, or test the connection directly on the command line with npx mcp-remote http://localhost:8787/sse. In rare cases, clear the credentials by running rm -rf ~/.mcp-auth.