fe-testgen-mcp

Сервис генерации модульных тестов для фронтенда на основе протокола MCP, сфокусированный на возможностях ИИ-анализа и генерации кода. Предоставляет инструменты MCP через HTTP Streaming, что позволяет интегрировать его с такими клиентами, как n8n, Cursor, Claude и другими.

Основные возможности

• Анализ матрицы тестирования: анализ изменений в коде, генерация списка функций и тестовых сценариев

• Генерация тестового кода: создание полных модульных тестов на основе матрицы

• Поддержка нескольких фреймворков: поддержка Vitest и Jest

• Покрытие различных сценариев: happy-path, edge-case, error-path, state-change

Related MCP server: Phabricator MCP Server

Быстрый старт

# 安装依赖
pnpm install

# 构建
pnpm build

# 启动服务
pnpm start

По умолчанию сервис прослушивает http://localhost:3000/mcp

Настройка окружения

Скопируйте env.example в .env и заполните необходимые параметры:

# 必需：OpenAI API 密钥
OPENAI_API_KEY=your_api_key

# 可选：自定义模型
OPENAI_MODEL=gpt-4

# 可选：服务配置
HTTP_PORT=3000
HTTP_HOST=0.0.0.0  # 允许外部访问

Инструменты MCP

analyze-test-matrix

Анализирует изменения в коде и генерирует матрицу тестирования.

Параметры:

Возвращаемые данные: список функций, тестовые сценарии, статистическая информация

generate-tests

Генерирует код модульных тестов.

Параметры:

Возвращаемые данные: массив тестовых случаев (включая путь к файлу, код, тип сценария)

Интеграция с n8n

Пример рабочего процесса

GitLab/Phabricator Webhook
    │
    ▼
读取 diff + rules 文件
    │
    ▼
调用 MCP generate-tests
    │
    ▼
写入测试文件 + 创建 MR
    │
    ▼
发送通知（企微/飞书）

Пример HTTP-запроса

curl -X POST http://localhost:3000/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "generate-tests",
      "arguments": {
        "rawDiff": "diff --git a/src/utils.ts ...",
        "framework": "vitest"
      }
    }
  }'

Формат файла rules

Создайте в проекте файл .cursor/rules/test-strategy.md:

# 测试生成规则

## 测试框架配置
- **测试框架**：vitest
- **测试文件模式**：**/*.{test,spec}.{ts,tsx}

## Mock 策略
- 使用 vi.fn() 进行函数 mock
- HTTP 请求优先 mock fetch/axios

n8n считывает содержимое этого файла и передает его в качестве параметра rules для MCP.

Развертывание в Docker

docker build -t fe-testgen-mcp .
docker run -d -p 3000:3000 \
  -e OPENAI_API_KEY=xxx \
  fe-testgen-mcp

Часто задаваемые вопросы

В: Как повысить согласованность результатов генерации?

О: Сервис по умолчанию использует temperature=0 и фиксированный seed=42, а также включает кэширование ответов.

В: Как указать тестовый фреймворк?

О: Приоритет: параметр framework > парсинг из rules > по умолчанию vitest

В: Какая версия Node.js требуется?

О: Node.js 18+ (рекомендуется 20+)