Remote MCP Server on Cloudflare

Name: Remote MCP Server on Cloudflare
Author: mthadley-workos

@mthadley-workos

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-mthadley-workos": {
      "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 reference implementation that demonstrates how to run a remote MCP (Model Context Protocol) server on Cloudflare Workers with OAuth login, enabling AI clients like Claude Desktop to call tools over HTTP.

How to use Remote MCP Server on Cloudflare?

Clone the repository, install dependencies, and run locally with npx nx dev remote-mcp-server. For production, deploy to Cloudflare Workers using npm run deploy after creating a KV namespace. Connect via MCP Inspector or configure a Claude Desktop client with the remote SSE URL.

Key features of Remote MCP Server on Cloudflare

Deploy a remote MCP server on Cloudflare Workers
OAuth-based authentication via Cloudflare Workers
Local development with hot reload
SSE transport for MCP communication
Integration with MCP Inspector for testing
Compatible with Claude Desktop via mcp-remote proxy

Use cases of Remote MCP Server on Cloudflare

Run an MCP server remotely for cloud-hosted AI assistants
Add tool-calling capabilities to Claude Desktop from a serverless endpoint
Prototype and test MCP tools locally before deploying globally
Demonstrate OAuth login flow for MCP servers

FAQ from Remote MCP Server on Cloudflare

What do I need to run this locally?

You need Node.js and npm. Clone the repo, install dependencies, then run npx nx dev remote-mcp-server to start the local server at http://localhost:8787.

How do I connect a remote MCP client to the deployed server?

Use the MCP Inspector with SSE transport and enter your Workers URL (e.g., https://worker-name.account-name.workers.dev/sse), then click Connect. For Claude Desktop, update its config with npx mcp-remote pointing to the same URL.

What authentication does the server use?

The server includes OAuth login. When connecting via MCP Inspector or Claude Desktop, you will be redirected to a login screen (mock in local development) that authenticates before tool access is granted.

What are the deployment requirements?

You need a Cloudflare Workers account and must create a KV namespace via npx wrangler kv namespace create OAUTH_KV. Add the namespace ID to wrangler.jsonc before running npm run deploy.

How do I debug connection issues?

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

Comments

More Cloud & Infrastructure MCP servers

GCP MCP

eniayomi

A Model Context Protocol (MCP) server that enables AI assistants like Claude to interact with your Google Cloud Platform environment. This allows for natural language querying and management of your GCP resources during conversations.

200

aws-finops-mcp-server

ravikiranvm

An MCP (Model Context Protocol) server that brings powerful AWS FinOps capabilities directly into your AI assistant. Analyze cloud costs, audit for waste, and get budget insights using natural language, all while keeping your credentials secure on your local machine.

179