开源 Freebuff MCP:让 Claude Code、Codex 统一接入 Freebuff
Swimming_Ask3859 · reddit · 2026-09-30
作者开源了 Freebuff MCP,一个桥接层,让 Codex、Claude Code 等 MCP 客户端直接操作 Freebuff Desktop 与 Freebuff CLI,而无需了解两者各自的接口。架构为:MCP 客户端 → Freebuff MCP → 统一的 session/turn 事件层 → Desktop 或 CLI 后端。
- 支持查找项目与线程、收发消息、启动/继续/暂停/停止任务、观察实时进度、切换模型设置、检查变更文件等
- 技术栈:TypeScript + Node.js、MCP SDK、node-pty(交互式 CLI 会话)、HTTP + SSE(与 Desktop 通信)、Zod、pnpm;含实验性 ACP 适配器与自动化测试
- 关键踩坑:MCP 包装器好写,失败时行为正确很难——曾把提交 prompt 误判为已完成 turn、取消只停了本地请求而非实际工作、进度流被误报为已连接等
- 设计要点:桥接层 ID 与 Freebuff 真实线程 ID 分离;有界事件存储 + 序列号游标避免重复推历史;取消操作传播到真正拥有该 turn 的后端并等待确认;SSE 处理重连、Last Event ID 与 Desktop 重启
- 安全层:限制项目文件读取、屏蔽凭据文件、拒绝二进制/超大文件、返回前脱敏常见密钥
仓库:github.com/Praket7/freebuff-mcp,作者欢迎 issue 与 PR。
「编程与Agent」频道最新
- Swords 框架推最大 Rust 版本 v0.3.0：子代理、代理交接、类型化工具输出 — KyeGomezB · 2026-09-30
- Agent 工程铁律：先造永远能跑完的慢路径，快路径只是优化 — victor_explore · 2026-09-30
- Hermes Agent 实用技巧:给 Bot 配独立桌面,遇到登录人工接管 — Teknium · 2026-09-30
- Whop 团队用编码智能体在云端真机上构建并审查移动应用 — eptwts · 2026-09-30
- GamowLabs 发布 LabBench：AI agent 难以选对下一个关键实验 — danielmckinn0n · 2026-09-30
- fal 推出面向所有人的 Agent,一站式完成图像视频音频 3D 创作 — adamho · 2026-09-30