fe-testgen-mcp
基于 MCP 协议的前端单元测试生成服务，支持从 Git 仓库或外部工作流获取代码差异，自动生成并修复测试用例。核心目标是提供“一条命令即可补齐测试”的能力，方便在 CI、n8n、Cursor/Claude 等客户端中直接调用。
概览
- 自动检测项目（Monorepo/测试框架）并解析 diff，生成测试矩阵与测试代码
- 支持 Vitest/Jest，提供 Worker 隔离以避免长测阻塞
- 通过 HTTP Streaming 或 stdio 暴露 MCP 工具，可嵌入编辑器和自动化流程
- 内置缓存、并发控制与监控上报，可按需开启
快速开始
npm install
npm run build
npm start # 自动选择 HTTP Streaming 或 stdio 模式
OPENAI_API_KEY=sk-xxx npm start -- --transport stdio
- 需要 Node.js 18+（推荐 20+）。
- 默认端点：HTTP
http://localhost:3000/mcp，SSEhttp://localhost:3000/sse。
配置速览
将必要的密钥与常用开关写在环境变量或 config.yaml 中：
OPENAI_API_KEY（必需）、OPENAI_MODEL（默认 gpt-4）- 传输：
TRANSPORT_MODE=stdio | httpStream，端口/地址通过HTTP_PORT、HTTP_HOST、HTTP_ENDPOINT覆盖 - Worker：
WORKER_ENABLED（默认 true）、WORKER_MAX_POOL（默认 3） - 日志与监控：
ENABLE_FILE_LOG、ENABLE_CONSOLE_LOG、TRACKING_ENABLED
核心工具
常用 MCP 工具（名称即调用名）：
fetch-commit-changes/fetch-diff-from-repo：从本地或远程仓库获取 diffanalyze-test-matrix/analyze-test-matrix-worker：分析功能与测试矩阵generate-tests/generate-tests-worker/generate-tests-from-raw-diff：生成测试代码write-test-file：将生成的用例落盘run-tests：执行 Vitest/Jest 并解析结果fix-failing-tests：基于失败日志自动修复测试test-generation-workflow：一键完成 diff → 生成 → 执行 → 修复
工作流示例
- 在 CI 或 n8n 获取 MR/PR diff（或使用
fetch-diff-from-repo）。 - 调用
generate-tests-from-raw-diff获取补齐的测试用例与统计信息。 - 如需落盘并验证，串联
write-test-file→run-tests→fix-failing-tests。
常见问题
- 需要禁用 HTTP 日志干扰时，保持默认
ENABLE_FILE_LOG=false、ENABLE_CONSOLE_LOG=false，或在开发模式下按需开启。 - 若遇到 undici 相关的
File is not defined，请确认 Node.js 版本 ≥18 并重新构建。