Remote MCP Server on Cloudflare

Name: Remote MCP Server on Cloudflare
Author: joe960913

@joe960913

代码仓库

关于 Remote MCP Server on Cloudflare

暂无概览

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

基本信息

分类

云与基础设施

运行时

node

传输方式

stdio

发布者

joe960913

配置

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

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

工具

未检测到工具

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

概览

What is Remote MCP Server on Cloudflare?

Remote MCP Server on Cloudflare is a guide and codebase for deploying a Model Context Protocol (MCP) server on Cloudflare Workers, complete with OAuth login. It enables developers to host MCP tools remotely 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 via npx nx dev remote-mcp-server. Use the MCP Inspector (npx @modelcontextprotocol/inspector) with SSE transport at http://localhost:8787/sse. For production, deploy with npx wrangler kv namespace create OAUTH_KV, update wrangler.jsonc, and run npm run deploy. Connect Claude Desktop by adding an mcpServers entry pointing to https://your-worker.workers.dev/sse using npx mcp-remote.

Key features of Remote MCP Server on Cloudflare

Runs MCP server on Cloudflare Workers.
Includes OAuth login integration.
Supports SSE transport for remote access.
Works with MCP Inspector for testing.
Connects to Claude Desktop via remote proxy.
Uses Cloudflare KV for OAuth state.

Use cases of Remote MCP Server on Cloudflare

Hosting custom MCP tools on a serverless platform.
Prototyping remote MCP servers with authentication.
Integrating Claude Desktop with externally hosted MCP tools.
Testing MCP server functionality using the MCP Inspector.
Deploying a production-ready remote MCP server.

FAQ from Remote MCP Server on Cloudflare

How do I run the server locally?

Clone the repo, install dependencies, and run npx nx dev remote-mcp-server. The server will be available at http://localhost:8787/.

How do I connect Claude Desktop to the server?

Add an entry to your Claude Desktop config file using "npx mcp-remote" with the SSE URL of your server (e.g., http://localhost:8787/sse for local, or the workers.dev URL after deployment). Restart Claude.

How do I deploy the server to Cloudflare?

Create a Cloudflare KV namespace with npx wrangler kv namespace create OAUTH_KV, add the namespace ID to wrangler.jsonc, then run npm run deploy. Your server will be available at worker-name.account-name.workers.dev.

How do I test the server with MCP Inspector?

Run npx @modelcontextprotocol/inspector, set Transport Type to SSE, enter your server’s /sse URL, and click Connect. Complete the OAuth login to list and call tools.

How do I debug connection issues?

Try restarting Claude, or connect directly via CLI using npx mcp-remote with the SSE URL. In rare cases, clear local authentication files with rm -rf ~/.mcp-auth.