Remote MCP Server on Cloudflare

Name: Remote MCP Server on Cloudflare
Author: happy-shine

@happy-shine

代码仓库

关于 Remote MCP Server on Cloudflare

暂无概览

基本信息

分类

云与基础设施

运行时

node

传输方式

stdio

发布者

happy-shine

配置

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

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

工具

未检测到工具

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

概览

What is Remote MCP Server on Cloudflare?

This project lets you run a Model Context Protocol (MCP) server on Cloudflare Workers with OAuth login. It provides a complete workflow for developing, deploying, and connecting remote MCP servers to MCP clients like Claude Desktop.

How to use Remote MCP Server on Cloudflare?

Clone the repository, install dependencies, and run locally with npx nx dev remote-mcp-server. Connect using the MCP Inspector or configure Claude Desktop via a local proxy (mcp-remote). Deploy to Cloudflare Workers by creating a KV namespace and running npm run deploy, then point your MCP client to the workers.dev/sse URL.

Key features of Remote MCP Server on Cloudflare

OAuth login for secure access to the MCP server.
Local development with MCP Inspector and SSE transport.
Deploy to Cloudflare Workers for a remote server.
Seamless integration with Claude Desktop via mcp-remote proxy.
Debugging commands and auth cache clearing.
Uses SSE (Server-Sent Events) as transport protocol.

Use cases of Remote MCP Server on Cloudflare

Run MCP tools locally for testing and development.
Connect Claude Desktop to a remote MCP server on Cloudflare.
Deploy a custom MCP server with OAuth authentication.
Debug MCP server connections using command-line tools.

FAQ from Remote MCP Server on Cloudflare

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

Edit Claude Desktop’s config file to include an entry with command: "npx", args: ["mcp-remote", "https://worker-name.account-name.workers.dev/sse"], and restart Claude.

How do I deploy the server to Cloudflare?

Run npx wrangler kv namespace create OAUTH_KV, add the KV namespace ID to wrangler.jsonc, then run npm run deploy.

How can I debug connectivity issues?

Try connecting directly via the command line with npx mcp-remote http://localhost:8787/sse. In rare cases, clear the auth cache with rm -rf ~/.mcp-auth.

What transport protocol does the server use?

The server uses SSE (Server-Sent Events). In the MCP Inspector, set Transport Type to SSE and enter the server’s /sse URL.

What is the purpose of the OAuth login?

The OAuth login provides authentication for the MCP server. When connecting from a client like the MCP Inspector or Claude Desktop, you are redirected to a login screen (locally a mock screen, in production Cloudflare’s OAuth).