Remote MCP Server on Cloudflare

Name: Remote MCP Server on Cloudflare
Author: chrisjpatty

@chrisjpatty

Repository

About Remote MCP Server on Cloudflare

No overview available yet

#mcp #cloudflare #remote-server

Basic information

Config

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

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

Remote MCP Server on Cloudflare is a project to set up an MCP (Model Context Protocol) server on Cloudflare Workers with OAuth login. It provides a template for developers to create, test locally, and deploy a remote MCP server that supports SSE transport and authentication.

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 by creating a KV namespace (npx wrangler kv namespace create OAUTH_KV), adding the namespace ID to wrangler.jsonc, and running npm run deploy. Connect clients such as the MCP Inspector or Claude Desktop by pointing them to the SSE endpoint (e.g., http://localhost:8787/sse locally or https://worker-name.account-name.workers.dev/sse remote).

Key features of Remote MCP Server on Cloudflare

Complete OAuth login flow for authentication
Local development with hot reload (npx nx dev)
Deployable to Cloudflare Workers with one command
Uses SSE (Server-Sent Events) transport for MCP
Integrates with MCP Inspector for testing
Works with Claude Desktop via mcp-remote proxy

Use cases of Remote MCP Server on Cloudflare

Deploy a remote MCP server with user authentication for AI assistants
Test MCP tools locally using the MCP Inspector with SSE transport
Connect Claude Desktop to a local or remote MCP server for tool calling
Implement custom MCP tools behind OAuth on Cloudflare’s edge network

FAQ from Remote MCP Server on Cloudflare

How do I run the server locally?

Clone the repository, run npm install, then start with npx nx dev remote-mcp-server and open http://localhost:8787/.

How do I connect the MCP Inspector to my server?

Start the inspector with npx @modelcontextprotocol/inspector, switch transport to SSE, and enter the server’s SSE URL (e.g., http://localhost:8787/sse). Log in with any email and password on the mock login screen.

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. The server will be available at your workers.dev URL.

How do I connect Claude Desktop to the server?

Edit Claude’s configuration file (Settings > Developer > Edit Config) and add an entry using mcp-remote with the SSE URL (e.g., http://localhost:8787/sse locally or the deployed URL). A browser window will open for OAuth login.

How do I debug connection issues?

Restart Claude, or test connectivity directly with npx mcp-remote http://localhost:8787/sse. In rare cases, clear authentication files with rm -rf ~/.mcp-auth.