用途
n8n-workflow-tester-safe 是一个安全的 MCP 服务器与 CLI 工具,专注于测试、评分和检查 n8n 工作流。它旨在解决大多数 n8n MCP 集成提供完整管理权限(凭据、破坏性操作、自动修复循环)所带来的风险,尤其适用于 CI、共享环境或自主代理场景。
主要能力
- 配置驱动的测试套件:通过 JSON 文件定义测试,支持工作流测试执行(webhook + API)与输出评估。
- 两级评分:每次测试运行产生两级分数。当 Tier 1 分数为 100(所有基础设施检查通过)、最终分数不低于质量阈值(默认 85)、且没有严重级别为 error 的问题时,测试通过。
- 执行轨迹追踪:提供执行检查与追踪功能。
- 内置节点目录:支持节点目录查询与验证。
- 工作流操作:支持工作流的增删改查(CRUD)以及图编辑(添加节点、连接)。
使用方式
可作为 MCP 服务器使用,适用于 Claude、OpenClaw 或任何支持 stdio 的 MCP 客户端;也可作为 CLI 使用,适用于脚本和 CI。MCP 客户端配置示例包括 Claude Code(~/.claude.json)和 OpenClaw / 任意 MCP 客户端。服务器使用 stdio 传输,兼容任何支持 stdio 的 MCP 客户端。
测试通过 JSON 文件定义。仓库的 workflows/ 目录中包含可直接使用的测试配置。
工具参考共 19 个工具,分为:测试(3 个)、工作流操作(5 个)、内省(5 个)、目录(5 个)。
设计约束
- 仅使用 stdio 传输,无 HTTP 服务器,无需管理认证。
- 显式工具面:19 个工具,每个都有明确用途。
- 依赖精简:仅 @modelcontextprotocol/sdk 和 zod。
- 无凭据生命周期管理,不读取、创建或删除凭据。
- 无代理式自动修复,只报告问题,不自动修复。
有意排除的功能
凭据管理、机密生命周期、破坏性恢复流程、自主 LLM 自动修复循环、生产部署操作。
未来改进方向(来自资料)
只读模式标志(禁用所有变更工具)、工作流差异摘要(前后对比)、常见模式的可复用评估预设、更丰富的轨迹可视化、测试负载的夹具库、用于 npx 的 npm 包。
适用场景
适用于希望在不承担完整管理权限风险的情况下测试 n8n 工作流的操作人员,尤其适合 CI、共享环境和自主代理。兼容 Claude、OpenClaw 及任何 MCP 客户端。
限制
资料中未提供安装命令、具体收费或价格信息、平台支持细节、实际使用步骤和效果数据。