适合谁
- 在 Cloudflare Workers/Durable Objects 平台上开发有状态 AI 智能体的 TypeScript 开发者
- 希望把自研 Agent 能力以 MCP 服务器形式对外提供的团队
- 需要调度、WebSocket、语音或工作流等一体化能力的智能体应用开发者
C
Cloudflare Agents
官方
基于 Cloudflare Durable Objects 构建持久化、有状态 AI 智能体的开源 SDK,MCP 服务器/客户端能力是其众多内置功能之一。
GitHub 源仓库 ↗
56FMRS · C
cloudflare/agents 是 Cloudflare 官方维护、功能全面且持续更新的智能体开发 SDK,MCP 服务器/客户端支持是其众多内置能力之一而非唯一定位;文档与示例丰富,但仓库当前不接受外部 PR,且没有独立于代码之外的现成 MCP 安装配置。
cloudflare/agents 是 Cloudflare 官方维护的 TypeScript SDK,用于在 Durable Objects 之上构建持久化、有状态的 AI 智能体(每个智能体拥有独立状态、存储与生命周期,空闲时休眠、按需唤醒)。它本身不是一个提供固定工具集的 MCP 服务器,而是一个应用框架:开发者可以用它把自己的 Agent 既作为 MCP 服务器对外暴露,也可以让 Agent 作为 MCP 客户端连接其他工具(支持 HTTP、SSE、RPC 与 elicitation)。除 MCP 外,SDK 还提供状态同步、可调用方法(RPC)、子智能体组合、任务调度、WebSocket 实时通信、AI 对话(含可续传流式响应)、WebMCP、durable 工作流(含人工审批)、邮件收发、语音管线、浏览器端智能体、Code Mode(LLM 生成可执行代码而非逐次工具调用)、沙箱化代码执行以及 x402 按次付费等能力。仓库以 pnpm workspace + Nx 管理多个包(核心 agents 包、ai-chat、think、codemode、shell、voice、worker-bundler、hono-agents),并提供 30 余个可独立运行的示例,其中包含多个 MCP 相关示例(mcp、mcp-client、mcp-server、mcp-worker、webmcp 等)。项目当前不接受外部 Pull Request,但欢迎通过 Issue 和 Discussion 反馈问题与需求。
工具能力
暂未整理工具清单。
安装接入
在现有 Cloudflare Workers 项目中运行 npm install agents,或使用 npm create cloudflare@latest -- --template cloudflare/agents-starter 新建项目。将 Agent 类声明为 Durable Object,在 wrangler.jsonc 中配置对应的 durable_objects 绑定及 SQLite 迁移(new_sqlite_classes),并设置合适的 compatibility_date 与 nodejs_compat 标志。若要将某个 Agent 暴露为 MCP 服务器或作为 MCP 客户端连接其他服务,可参考仓库 examples/mcp* 目录中的示例代码自行实现,该功能没有独立的一键安装配置。
选型与风险
不适合谁
- 只想要一个开箱即用、可直接填入 Claude Desktop 配置的固定工具 MCP 服务器的用户
- 不使用 Cloudflare Workers/Durable Objects 作为部署目标的团队
- 希望通过提交 PR 参与代码贡献的外部开发者(仓库当前不接受外部 PR)
所需权限
- Cloudflare 账户及已启用 SQLite 存储的 Durable Objects 权限
- Workers 部署与绑定配置权限
- 按所用功能可能需要的 AI 模型调用凭据、邮件服务绑定等额外权限
风险与副作用
- MCP 服务器/客户端能力由开发者自行实现,若未正确设计鉴权,可能暴露 Agent 状态或可调用方法
- Code Mode 与沙箱化代码执行运行 LLM 生成的代码,隔离配置不当可能带来执行风险
- Durable Object 绑定或 SQLite 迁移配置错误可能导致状态丢失或迁移失败
- 仓库不接受外部 PR,社区发现的问题只能通过 Issue 等待官方修复,响应速度不受贡献者控制
常见排障
- 确认 `wrangler.jsonc` 中的 `durable_objects` 绑定名称与迁移 `new_sqlite_classes` 中的类名完全一致
- 检查 `compatibility_date` 与 `nodejs_compat` 标志是否按 README 示例正确设置
- 构建仓库本身需要 Node 24+ 及 pnpm,可运行 `pnpm run check` 排查类型/格式/测试问题
- 参考 `examples/mcp*`、`examples/webmcp` 等目录中的示例代码定位 MCP 相关集成问题
- 查阅 `docs/` 与 `design/` 目录获取架构说明与设计决策记录
使用场景
为每个用户/会话/房间创建独立的持久化、可休眠的智能体实例
将自定义 Agent 逻辑封装并对外暴露为 MCP 服务器
让 Agent 作为 MCP 客户端调用外部工具与其他 MCP 服务器
构建带状态同步、可调用方法的实时聊天或协作前端(React/原生 JS)
实现带人工审批环节的多步骤 durable 工作流
支持客户端
暂未确认支持的客户端。