Remote MCP Server on Cloudflare

Name: Remote MCP Server on Cloudflare
Author: hamishll

@hamishll

代码仓库

关于 Remote MCP Server on Cloudflare

暂无概览

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

基本信息

分类

云与基础设施

运行时

node

传输方式

stdio

发布者

hamishll

配置

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

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

工具

未检测到工具

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

概览

What is Remote MCP Server on Cloudflare?

Remote MCP Server on Cloudflare is a template to run a remote MCP (Model Context Protocol) server on Cloudflare Workers, complete with OAuth login. It is intended for developers who want to expose MCP tools over HTTP and connect them to clients like Claude Desktop.

How to use Remote MCP Server on Cloudflare?

Clone the repository, install dependencies, and run npx nx dev remote-mcp-server to start locally. Deploy with npx wrangler kv namespace create OAUTH_KV, add the KV namespace ID to wrangler.jsonc, and run npm run deploy. Connect clients (e.g., MCP Inspector or Claude Desktop) using the /sse endpoint.

Key features of Remote MCP Server on Cloudflare

Remote MCP server deployed on Cloudflare Workers.
OAuth-based authentication for login.
Supports SSE (Server-Sent Events) transport.
Local development with MCP Inspector.
Easy integration with Claude Desktop.
Debugging via command-line proxy (mcp-remote).

Use cases of Remote MCP Server on Cloudflare

Hosting MCP tools accessible from any remote MCP client.
Connecting Claude Desktop to a cloud-based MCP server.
Testing MCP server functionality locally before deployment.
Building custom MCP tools with Cloudflare Workers.

FAQ from Remote MCP Server on Cloudflare

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

Edit Claude Desktop’s config file (Settings > Developer > Edit Config) and add an entry with command: "npx", args: ["mcp-remote", "<workers.dev URL>/sse"].

What transport does Remote MCP Server on Cloudflare use?

The server uses SSE (Server-Sent Events) transport, accessed via the /sse endpoint on the Worker’s URL.

What dependencies or runtime are required?

Local development requires Node.js and npm. The server runs on Cloudflare Workers, which is a serverless environment; a KV namespace (OAUTH_KV) must be created for OAuth state.

How can I debug connection issues?

Restart Claude or test connectivity directly with npx mcp-remote http://localhost:8787/sse. Clearing ~/.mcp-auth may help in rare cases.

Does the server require authentication?

Yes, the server includes OAuth login. During local development with the MCP Inspector, a mock login screen is shown; in production, OAuth is handled by Cloudflare Workers.