MCP.so
Sign In

Remote MCP Server on Cloudflare

@mthadley-workos

Repository

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-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.

Frequently asked questions

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

Basic information

Category

Cloud & Infrastructure

Transports

stdio

Author

mthadley-workos

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

Lambda MCP Server Demo (Streamable HTTP)

mikegc-aws

Creates a simple MCP tool server with "streaming" HTTP.

234

MCP Gateway

mcp-ecosystem

🧩 MCP Gateway - A lightweight gateway service that instantly transforms existing MCP Servers and APIs into MCP servers with zero code changes. Features Docker deployment and management UI, requiring no infrastructure modifications.

2.2K

AWS MCP

RafalWilinski

Talk with your AWS using Claude. Model Context Protocol (MCP) server for AWS. Better Amazon Q alternative.

295

Azure DevOps MCP Server

Tiberriver256

An MCP server for Azure DevOps

377