Remote MCP Server on Cloudflare

Name: Remote MCP Server on Cloudflare
Author: grocco

@grocco

代码仓库

关于 Remote MCP Server on Cloudflare

暂无概览

#remote-mcp-server #cloudflare #mcp-inspector

基本信息

分类

云与基础设施

运行时

node

传输方式

stdio

发布者

grocco

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "remote-mcp-server-grocco": {
      "command": "npx",
      "args": [
        "nx",
        "dev",
        "remote-mcp-server"
      ]
    }
  }
}

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is Remote MCP Server on Cloudflare?

Remote MCP Server on Cloudflare is a blueprint for running a remote MCP (Model Context Protocol) server on Cloudflare Workers with OAuth login. It is intended for developers who want to deploy a secure, serverless MCP endpoint that can be accessed by MCP clients like Claude Desktop or the MCP Inspector.

How to use Remote MCP Server on Cloudflare?

Clone the repository, install dependencies with npm install, and run locally with npx nx dev remote-mcp-server. To deploy, create a KV namespace for OAuth (npx wrangler kv namespace create OAUTH_KV), add its id to wrangler.jsonc, then run npm run deploy. Clients connect via SSE at the /sse endpoint, optionally using a local proxy like mcp-remote.

Key features of Remote MCP Server on Cloudflare

Deployable to Cloudflare Workers as a serverless endpoint
OAuth login for secure authenticated access
Uses SSE transport for MCP communication
Works with the official MCP Inspector for testing
Connects to Claude Desktop via a local mcp-remote proxy
Stores OAuth state in a Cloudflare KV namespace

Use cases of Remote MCP Server on Cloudflare

Deploy a custom MCP server to production without managing infrastructure
Test and debug MCP tools locally with the MCP Inspector
Connect Claude Desktop to a remote MCP server via OAuth
Build a serverless MCP endpoint that multiple users can authenticate to

FAQ from Remote MCP Server on Cloudflare

How do I develop locally?

Clone the repo, run npm install, then npx nx dev remote-mcp-server. The server will be available at http://localhost:8787/. Use the MCP Inspector with SSE at http://localhost:8787/sse to test.

How do I deploy to Cloudflare?

Create a KV namespace with npx wrangler kv namespace create OAUTH_KV, add its ID to wrangler.jsonc, then run npm run deploy. Your server will be available at a workers.dev URL.

How do I connect Claude Desktop to my remote MCP server?

Add an entry to Claude Desktop’s config file using npx mcp-remote pointing to your worker’s /sse endpoint (e.g., https://worker-name.account-name.workers.dev/sse). Restart Claude; it will open a browser for OAuth login.

How can I debug connection issues?

Restart Claude, or test directly with npx mcp-remote http://localhost:8787/sse. To clear cached OAuth state, remove the ~/.mcp-auth directory with rm -rf ~/.mcp-auth.