mcpField
B
Building a Remote MCP Server on Cloudflare (Without Auth)

Building a Remote MCP Server on Cloudflare (Without Auth)

本地服务
github.com/gotalab开发工具01 周前更新

关于 Building a Remote MCP Server on Cloudflare (Without Auth)

此示例提供在 Cloudflare Workers 上部署无需身份验证的远程 MCP 服务的模板,适合希望添加自定义工具并让 MCP 客户端连接托管端点的开发者。

主要功能

  1. 01在 Cloudflare Workers 部署免认证远程服务
  2. 02在服务初始化方法中添加工具
  3. 03本地开发与测试

适用场景

  1. 01创建无需身份验证的远程 MCP 服务
  2. 02为基于 Workers 的服务添加自定义工具
  3. 03将 MCP 客户端连接到已部署端点

MCP 相关

示例部署带 SSE 端点的远程 MCP 服务,可连接 Cloudflare AI Playground,或通过 mcp-remote 连接本地客户端。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
"mcpServers": {
"remote-mcp-server-authless-gotalab": {
"command": "npx",
"args": [
"-y",
"mcp-remote"
]
}
}
}
启动命令npx -y mcp-remote

本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。

安装包
npmmcp-remote

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。

详细介绍

在 Cloudflare 上构建远程 MCP 服务(无需身份验证)

此示例可让你在 Cloudflare Workers 上部署无需身份验证的远程 MCP 服务。

开始使用:

部署到 Workers

这会将你的 MCP 服务部署到类似以下的 URL:remote-mcp-server-authless.<your-account>.workers.dev/sse

或者,你可以使用下面的命令行,在本地计算机上创建远程 MCP 服务:

npm create cloudflare@latest -- my-mcp-server --template=cloudflare/ai/demos/remote-mcp-authless

开发此代码库

请使用 Node.js 24.22.1 或更新的 24.x 安全版本,以及 pnpm 12.14.0 (package.json 中指定的版本)。Node.js 用于运行本地开发工具; 部署后的服务运行在 Cloudflare Workers 上。

pnpm install --frozen-lockfile
pnpm typecheck
pnpm test
pnpm build # bundle only; does not deploy
pnpm dev

上面的 npm 脚手架命令和下面的 npx 客户端配置仍受支持。它们与此代码库的开发工具相互独立。

自定义 MCP 服务

如需向 MCP 服务添加自己的工具,请在 src/index.ts 的 init() 方法中使用 this.server.tool(...) 定义每个工具。

连接到 Cloudflare AI Playground

你可以从 Cloudflare AI Playground 连接到 MCP 服务。它是一个远程 MCP 客户端:

  1. 前往 https://playground.ai.cloudflare.com/
  2. 输入已部署的 MCP 服务 URL(remote-mcp-server-authless.<your-account>.workers.dev/sse)
  3. 现在即可直接在 Playground 中使用 MCP 工具!

将 Claude Desktop 连接到 MCP 服务

你也可以使用 mcp-remote 代理,从本地 MCP 客户端连接到远程 MCP 服务。

如需从 Claude Desktop 连接到 MCP 服务,请按照 Anthropic 的快速入门指南操作,然后在 Claude Desktop 中前往 Settings > Developer > Edit Config。

使用以下配置进行更新:

{
  "mcpServers": {
    "calculator": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "http://localhost:8787/sse"  // or remote-mcp-server-authless.your-account.workers.dev/sse
      ]
    }
  }
}

重启 Claude 后,你应该就能看到可用的工具。

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。