Remote MCP Server on Cloudflare

@alexcraviotto

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-alexcraviotto": {
      "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 deploy a remote MCP (Model Context Protocol) server on Cloudflare Workers with OAuth login, enabling tools to be called from remote MCP clients like Claude Desktop.

How to use Remote MCP Server on Cloudflare?

Clone the repository, install dependencies with npm install, then run locally with npx nx dev remote-mcp-server. Connect using the MCP Inspector with SSE transport (e.g., http://localhost:8787/sse). For Claude Desktop, configure mcpServers with npx mcp-remote pointing to the SSE URL. Deploy to production with npm run deploy after creating an OAuth KV namespace.

Key features of Remote MCP Server on Cloudflare

Runs on Cloudflare Workers with zero cold starts
Built-in OAuth login flow for authentication
Supports local development with hot-reload
Connects to MCP Inspector and Claude Desktop
Deployed via a single npm command

Use cases of Remote MCP Server on Cloudflare

Hosting a custom MCP tool server with user authentication
Testing MCP tools locally before production deployment
Connecting Claude Desktop to a remote tool server via SSE
Building a secure, serverless MCP endpoint for any MCP client

FAQ from Remote MCP Server on Cloudflare

What dependencies or runtime are required?

Node.js and npm are required for local development, running the MCP Inspector, and the mcp-remote proxy. The deployed server runs on Cloudflare Workers with a KV namespace for OAuth state.

How do I connect to the server remotely?

Use an MCP client (e.g., MCP Inspector or Claude Desktop) with the SSE transport and the Worker’s workers.dev URL (e.g., https://worker-name.account-name.workers.dev/sse). The client must support OAuth redirect for login.

Where does OAuth data live?

OAuth session data is stored in a Cloudflare KV namespace (OAUTH_KV) created during deployment setup and referenced in wrangler.jsonc.

How can I debug connection issues?

Restart the MCP client or try connecting directly via command line: npx mcp-remote http://localhost:8787/sse. In rare cases, clear the local auth cache with rm -rf ~/.mcp-auth.

What transport method does the server use?

The server uses Server-Sent Events (SSE) as the MCP transport, accessible at the /sse endpoint of both the local and deployed Worker URLs.

Frequently asked questions

What dependencies or runtime are required?

Node.js and npm are required for local development, running the MCP Inspector, and the `mcp-remote` proxy. The deployed server runs on Cloudflare Workers with a KV namespace for OAuth state.

How do I connect to the server remotely?

Use an MCP client (e.g., MCP Inspector or Claude Desktop) with the SSE transport and the Worker’s `workers.dev` URL (e.g., `https://worker-name.account-name.workers.dev/sse`). The client must support OAuth redirect for login.

Where does OAuth data live?

OAuth session data is stored in a Cloudflare KV namespace (`OAUTH_KV`) created during deployment setup and referenced in `wrangler.jsonc`.

How can I debug connection issues?

Restart the MCP client or try connecting directly via command line: `npx mcp-remote http://localhost:8787/sse`. In rare cases, clear the local auth cache with `rm -rf ~/.mcp-auth`.

What transport method does the server use?

The server uses Server-Sent Events (SSE) as the MCP transport, accessible at the `/sse` endpoint of both the local and deployed Worker URLs.

Comments

Basic information

More Cloud & Infrastructure MCP servers

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