Remote MCP Server on Cloudflare

Name: Remote MCP Server on Cloudflare
Author: shixixiyue

@shixixiyue

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-shixixiyue": {
      "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 template for deploying a remote MCP (Model Context Protocol) server on Cloudflare Workers with OAuth login. It provides a ready-to-run example 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 using npx nx dev remote-mcp-server. Connect the MCP Inspector by setting Transport Type to SSE and the URL to http://localhost:8787/sse. For Claude Desktop, update its configuration file with a npx mcp-remote command pointing to the server's SSE endpoint. Deploy to Cloudflare with npm run deploy after creating a KV namespace and adding its ID to wrangler.jsonc.

Key features of Remote MCP Server on Cloudflare

Local development with hot-reload via Nx.
OAuth login included for secure access.
Connect via MCP Inspector for testing.
Integrates with Claude Desktop through a local proxy.
Deploy to Cloudflare Workers with one command.
Debugging helpers like mcp-remote and auth cache clearing.

Use cases of Remote MCP Server on Cloudflare

Deploying math or other tool servers remotely for AI assistants.
Building and testing MCP tools locally before deployment.
Enabling Claude Desktop to call tools hosted on Cloudflare.
Creating a remote tool server with OAuth authentication.

FAQ from Remote MCP Server on Cloudflare

How do I debug connection issues?

Restart Claude, or try connecting directly using npx mcp-remote http://localhost:8787/sse. If problems persist, clear the auth cache with rm -rf ~/.mcp-auth.

How do I deploy the server to Cloudflare?

Run npx wrangler kv namespace create OAUTH_KV, add the returned KV namespace ID to wrangler.jsonc, then run npm run deploy.

How do I connect the MCP Inspector?

Start it with npx @modelcontextprotocol/inspector, switch Transport Type to SSE, enter the server's SSE URL (e.g., http://localhost:8787/sse), and click Connect. You will see a mock login screen.

What dependencies or runtime does this server require?

It runs on Cloudflare Workers and uses a KV namespace for OAuth data. Local development requires Node.js and npm.

Does the server include a real authentication provider?

No, the included OAuth screen is a mock. You can enter any email and password to log in locally. For production, you would replace it with a real OAuth provider.

Comments

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

AWS Model Context Protocol (MCP) Server

alexei-led

A lightweight service that enables AI assistants to execute AWS CLI commands (in safe containerized environment) through the Model Context Protocol (MCP). Bridges Claude, Cursor, and other MCP-aware AI tools with AWS CLI for enhanced cloud infrastructure management.

184