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

Fetch the live tool list by running this server in a temporary sandbox using the button above.

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

container-use

aluzzardi

Development environments for coding agents. Enable multiple agents to work safely and independently with your preferred stack.

3.9K

Terraform MCP Server

hashicorp

The Terraform MCP Server provides seamless integration with Terraform ecosystem, enabling advanced automation and interaction capabilities for Infrastructure as Code (IaC) development.

1.5K

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

K8s MCP Server

alexei-led

K8s-mcp-server is a Model Context Protocol (MCP) server that enables AI assistants like Claude to securely execute Kubernetes commands. It provides a bridge between language models and essential Kubernetes CLI tools including kubectl, helm, istioctl, and argocd, allowing AI syste

212