Remote MCP Server on Cloudflare

Name: Remote MCP Server on Cloudflare
Author: MichaelYangjson

@MichaelYangjson

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-michaelyangjson": {
      "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?

A starter project that runs a remote MCP (Model Context Protocol) server on Cloudflare Workers with OAuth login. It provides a template for developers to deploy, test, and connect MCP tools to clients such as Claude Desktop or the MCP Inspector over SSE transport.

How to use Remote MCP Server on Cloudflare?

Clone the repository, install dependencies with npm install, and run locally via npx nx dev remote-mcp-server. Use the MCP Inspector or Claude Desktop (with npx mcp-remote) to connect to the server. Deploy to Cloudflare by creating an OAUTH_KV namespace with wrangler and running npm run deploy.

Key features of Remote MCP Server on Cloudflare

Runs on Cloudflare Workers with OAuth-based login
Supports SSE transport for MCP clients
Includes local development and debugging instructions
Integrates with the MCP Inspector for testing
Connects directly to Claude Desktop via a remote proxy
Provides a deployable server accessible at a workers.dev URL

Use cases of Remote MCP Server on Cloudflare

Hosting custom MCP tools accessible from any MCP client over the internet
Developing and testing MCP integrations locally before deploying to Cloudflare
Enabling Claude Desktop to call remote tools through an authenticated SSE endpoint
Learning how to build and deploy a remote MCP server with OAuth flow

FAQ from Remote MCP Server on Cloudflare

How do I run the server locally?

Clone the repository, run npm install, and then execute npx nx dev remote-mcp-server. The server will be available at http://localhost:8787/.

How can I test the server with the MCP Inspector?

Start the inspector with npx @modelcontextprotocol/inspector, switch transport to SSE, and enter http://localhost:8787/sse (or your workers.dev URL after deploy) as the server URL. You will be redirected to a login screen before you can list and call tools.

How do I connect Claude Desktop to the remote server?

Add an entry to Claude Desktop's config file with command npx, args ["mcp-remote", "https://worker-name.account-name.workers.dev/sse"]. Restart Claude; a browser window will open for OAuth login.

What happens if something goes wrong?

Restart Claude, or test the connection manually with npx mcp-remote http://localhost:8787/sse. In rare cases, clear the auth cache by deleting ~/.mcp-auth.