适合谁
- 已经使用 Binex 并希望通过编码智能体检查运行记录的开发者
- 需要本地优先、可调试智能体工作流工具链的团队
B
45FMRS · D
Binex 是一个本地优先、MIT 许可的 AI 智能体工作流运行时，其 MCP 服务器将运行、评估与产物暴露给编码智能体。它适合希望在不迁移现有框架的前提下调试和比较工作流的开发者，但要求本地安装 Python 3.11+ 的 Binex，且不提供托管云服务。
Binex 是一个开源、完全本地运行的 AI 智能体工作流运行时，提供 DAG 流水线、产物血缘关系和可重放运行。它通过 binex mcp serve 将运行记录、评估和产物以 MCP 工具的形式暴露出来，供 Claude Code、Cursor 等兼容 MCP 的智能体调用。其源码基于 Python、React、FastAPI 和 TypeScript 构建，采用 MIT 许可证，不含遥测。
工具能力
binex_debug
以事后检查方式查看某次运行的逐节点输入与输出。
binex_eval_run
针对已批准的基线运行 YAML 评估套件，用于回归测试。
binex_diff
对两次运行进行并排比较，支持过滤变更、失败与成本差异。
安装接入
- 安装：
pip install binex（需要 Python 3.11+）。 - 将 Binex 注册为 MCP 服务器：
claude mcp add binex -- binex mcp serve。 - 在 Claude Code、Cursor 或其他兼容 MCP 的客户端中启动，即可使用 binex_debug、binex_eval_run、binex_diff 等工具。
claude_desktop_config.json
{"mcpServers":{"binex":{"command":"binex","args":["mcp","serve"]}}}
选型与风险
不适合谁
- 希望使用托管云端追踪服务而非本地运行时的用户
- 未安装 Python 3.11+ 或 Binex 的环境
所需权限
- 读取与写入 Binex 本地存储（默认 `.binex` 目录，含 SQLite 数据库与 JSON 产物文件）
- 读取本机配置的 LLM 提供商 API 密钥（用于运行工作流）
- 通过 stdio 与 MCP 客户端进程通信
风险与副作用
- 暴露的运行记录、评估与产物会写入本地 `.binex` 目录，可能包含敏感提示词或输出
- 若配置了云端 LLM 提供商，提示词与数据会发送至相应提供商
- 任何能调用该 MCP 服务器的本地进程都可读取运行数据
常见排障
- 确认 `binex` 命令已在 PATH 中且 Python 版本为 3.11 或更高
- 检查 MCP 客户端配置中命令与参数是否为 `binex mcp serve`
- 确认 `.binex` 存储目录可读写，或检查 `BINEX_STORE_PATH` 环境变量
- 若工具未出现，重启 MCP 客户端并查看其日志
使用场景
在 Claude Code 或 Cursor 中直接调试和检查 Binex 工作流运行记录
对智能体流水线运行评估套件并对比基线
比较两次运行以定位节点级差异与成本变化
支持客户端
Claude Code完整支持
Cursor部分支持