关于 Building a Remote MCP Server on Cloudflare (Without Auth)
此示例提供在 Cloudflare Workers 上部署无需身份验证的远程 MCP 服务的模板,适合希望添加自定义工具并让 MCP 客户端连接托管端点的开发者。
主要功能
- 01在 Cloudflare Workers 部署免认证远程服务
- 02在服务初始化方法中添加工具
- 03本地开发与测试
适用场景
- 01创建无需身份验证的远程 MCP 服务
- 02为基于 Workers 的服务添加自定义工具
- 03将 MCP 客户端连接到已部署端点
MCP 相关
示例部署带 SSE 端点的远程 MCP 服务,可连接 Cloudflare AI Playground,或通过 mcp-remote 连接本地客户端。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
工具
本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。
详细介绍
在 Cloudflare 上构建远程 MCP 服务(无需身份验证)
此示例可让你在 Cloudflare Workers 上部署无需身份验证的远程 MCP 服务。
开始使用:
这会将你的 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 客户端:
- 前往 https://playground.ai.cloudflare.com/
- 输入已部署的 MCP 服务 URL(
remote-mcp-server-authless.<your-account>.workers.dev/sse) - 现在即可直接在 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 后,你应该就能看到可用的工具。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。