Remote MCP Server on Cloudflare

@sunnypra

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-sunnypra": {
      "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 guide and starter project to deploy a remote Model Context Protocol (MCP) server on Cloudflare Workers with OAuth login, enabling clients like Claude Desktop to call tools over the internet.

How to use Remote MCP Server on Cloudflare?

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

Key features of Remote MCP Server on Cloudflare

Deploy MCP server as a Cloudflare Worker
OAuth login for secure tool access
SSE-based transport for remote connections
Local development with hot reload via Nx
Ready integration with MCP Inspector and Claude Desktop

Use cases of Remote MCP Server on Cloudflare

Host a math tool server accessible from any MCP client
Connect Claude Desktop to remote MCP tools over the internet
Develop and test MCP servers locally before deploying
Provide external teams with OAuth-protected MCP endpoints

FAQ from Remote MCP Server on Cloudflare

How do I connect Claude Desktop to the remote server?

Update your Claude configuration to use mcp-remote with the server’s workers.dev URL (e.g., https://worker-name.account-name.workers.dev/sse). Restart Claude – a browser window will open for OAuth login.

What transport type is used?

The server uses Server-Sent Events (SSE). When connecting via MCP Inspector, set Transport Type to SSE and enter the server URL followed by /sse.

What are the deployment steps?

Create a KV namespace with npx wrangler kv namespace create OAUTH_KV, add its ID to wrangler.jsonc, then run npm run deploy. The server will be available at a workers.dev URL.

How do I debug connection issues?

Restart Claude or try connecting directly from the command line with npx mcp-remote http://localhost:8787/sse. Rarely, clear the auth cache with rm -rf ~/.mcp-auth.

What runtime dependencies are required?

Node.js, npm, a Cloudflare account, and the Cloudflare Workers CLI (wrangler). The project uses Nx for local development and mcp-remote for client proxying.

Frequently asked questions

How do I connect Claude Desktop to the remote server?

Update your Claude configuration to use `mcp-remote` with the server’s `workers.dev` URL (e.g., `https://worker-name.account-name.workers.dev/sse`). Restart Claude – a browser window will open for OAuth login.

What transport type is used?

The server uses Server-Sent Events (SSE). When connecting via MCP Inspector, set Transport Type to `SSE` and enter the server URL followed by `/sse`.

What are the deployment steps?

Create a KV namespace with `npx wrangler kv namespace create OAUTH_KV`, add its ID to `wrangler.jsonc`, then run `npm run deploy`. The server will be available at a `workers.dev` URL.

How do I debug connection issues?

Restart Claude or try connecting directly from the command line with `npx mcp-remote http://localhost:8787/sse`. Rarely, clear the auth cache with `rm -rf ~/.mcp-auth`.

What runtime dependencies are required?

Node.js, npm, a Cloudflare account, and the Cloudflare Workers CLI (`wrangler`). The project uses Nx for local development and `mcp-remote` for client proxying.