fe-testgen-mcp

基于 MCP 协议的前端单元测试生成服务，支持从 Git 仓库或外部工作流获取代码差异，自动生成并修复测试用例。核心目标是提供“一条命令即可补齐测试”的能力，方便在 CI、n8n、Cursor/Claude 等客户端中直接调用。

概览

• 自动检测项目（Monorepo/测试框架）并解析 diff，生成测试矩阵与测试代码

• 支持 Vitest/Jest，提供 Worker 隔离以避免长测阻塞

• 通过 HTTP Streaming 或 stdio 暴露 MCP 工具，可嵌入编辑器和自动化流程

• 内置缓存、并发控制与监控上报，可按需开启

快速开始

• 需要 Node.js 18+（推荐 20+）。

• 默认端点：HTTP http://localhost:3000/mcp，SSE http://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：从本地或远程仓库获取 diff

• analyze-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 → 生成 → 执行 → 修复

工作流示例

1. 在 CI 或 n8n 获取 MR/PR diff（或使用 fetch-diff-from-repo）。

2. 调用 generate-tests-from-raw-diff 获取补齐的测试用例与统计信息。

3. 如需落盘并验证，串联 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 并重新构建。