🤖 AI Testcase Generator MCP

Сервер Model Context Protocol (MCP), который генерирует комплексные планы тестирования API (позитивные, негативные и граничные/крайние случаи) непосредственно из метаданных конечных точек — на базе LLM.

Это сервер Model Context Protocol (MCP) на TypeScript для инженеров по обеспечению качества. Он демонстрирует основные концепции Model Context Protocol, предоставляя:

• Инструмент на базе ИИ для генерации исчерпывающих планов тестовых сценариев из API-эндпоинтов и полезных нагрузок

• Интеграция LLM на основе промптов для качества и покрытия

• Расширяемая структура для будущих инструментов автоматизации

✨ Возможности

• 🔌 Сервер, совместимый с MCP (транспорт stdio).

• 📝 Инструмент: generate_tests_excel

  • Входные данные: endpoint, HTTP-метод, полезная нагрузка, дополнительный контекст.

  • Варианты ввода:

    • Прямые данные эндпоинта: endpoint, HTTP-метод, полезная нагрузка

    • Используйте extraContext для предоставления любых дополнительных заметок или ограничений по тестированию

  • Выходные данные: 📊 Excel-план тестирования со столбцами: Sl no, Test Name, Pre-Condition, Steps, Expected Result.

• 🧠 Генерация тестов на основе промптов с настраиваемой LLM (Groq, OpenAI, Anthropic).

• 📜 Подробное логирование с помощью Winston.

Related MCP server: ai-testcase-generator-mcp

🏗️ Архитектура

flowchart TD
    A[Claude / MCP Client] -->|Run Tool| B[MCP Server]
    B -->|Prompt| C[LLM API]
    C -->|Test Cases JSON| B
    B -->|Excel Export| D[(Test Plan .xlsx)]
    B -->|Logs| E[Server Log File]

📂 Структура проекта

ai-testcase-designer-mcp/
├── build/                         # Compiled JavaScript output
├── assets/                        # Demo gifs, images, and sample files
│    ├── demo.gif
│    ├── excel_preview.png
│    └── sample_chat_message.txt
├── configs/
│    └── config.json               # Server/tool config
├── src/
│    ├── index.ts                  # Main server entry point (MCP interface & routing)
│    ├── excel.ts                  # Excel file creation & writing logic (modular)
│    ├── logger.ts                 # Winston logger configuration & log writing (modular)
│    └── prompts/
│         └── testcase_prompt.txt  # Prompt template for LLM-based test generation
├── package.json
├── tsconfig.json
├── README.md
└── .gitignore

• src/excel.ts: Обрабатывает создание всех файлов Excel (.xlsx) и экспорт плана тестирования (модульно).

• src/logger.ts: Предоставляет модульную функциональность логирования на сервере MCP с использованием Winston.

• src/prompts/: Содержит шаблоны промптов для генерации тестов на основе LLM.

• assets/: Демо-GIF, предпросмотр образца Excel и примеры чат-промптов.

🎥 Демо

Вот MCP, генерирующий тестовые сценарии и экспортирующий их в Excel:

🔍 Предпросмотр Excel

Ниже приведен краткий предпросмотр сгенерированных тестовых сценариев:

Разработка

Установите зависимости:

npm install

Соберите сервер:

npm run build

Для разработки с автоматической пересборкой:

npm run watch

⚙️ Установка

Выполните следующие шаги, чтобы настроить MCP-сервер AI Testcase Designer локально:

1. Клонируйте репозиторий

   git clone 
   cd ai-testcase-designer-mcp

2. Установите зависимости

   npm install

3. Соберите сервер

   npm run build

4. Настройте сервер в вашем MCP-клиенте

   a. Claude Desktop или любой MCP-совместимый клиент

   • Добавьте следующую конфигурацию сервера:

     • На MacOS:
       ~/Library/Application Support/Claude/claude_desktop_config.json

     • На Windows:
       %APPDATA%/Claude/claude_desktop_config.json

   {
     "mcpServers": {
       "ai-testcase-designer-mcp": {
         "disabled": false,
         "timeout": 60,
         "command": "node",
         "args": [
           "c:/Auto_WS/ai-testcase-designer-mcp/build/index.js"
         ],
         "transportType": "stdio"
       }
     }
   }

   b. Cline (расширение VS Code)

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

   1. Установите Cline из маркетплейса VS Code.

   2. Откройте боковую панель Cline (из панели действий VS Code).

   3. Перейдите в раздел "MCP Servers" и нажмите "Add New MCP Server".

   4. Заполните данные сервера:

      {
        "mcpServers": {
          "ai-testcase-designer-mcp": {
            "disabled": false,
            "timeout": 60,
            "command": "node",
            "args": [
              "c:/Auto_WS/ai-testcase-designer-mcp/build/index.js"
            ],
            "transportType": "stdio"
          }
        }
      }

   5. Проверьте соединение и сохраните.

   Визуальное пошаговое руководство см. ниже:

   

   

   Подробные инструкции по Cline см. в официальной документации:
   cline.bot/getting-started/installing-cline#vs-code-marketplace%3A-step-by-step-setup

c. Hermes Agent

• Добавьте следующую конфигурацию сервера в ~/.hermes/config.yaml в раздел mcp_servers:

mcp_servers:
  ai-testcase-designer-mcp:
    command: "node"
    args: ["/absolute/path/to/ai-testcase-designer-mcp/build/index.js"]

🔑 Настройка API-ключа и рабочей директории

Для использования AI Testcase Designer MCP.

1. Получите бесплатный API-ключ Groq здесь: https://console.groq.com/keys

2. Рабочая директория (WORK_DIR), в которой будут сохраняться сгенерированные Excel-планы тестирования и журналы сервера.

Обновите файл config.json следующим образом:

{
  "MODEL_API_KEY": "gsk_7Ma3Fabcd <your-api-key-here>",
  "WORK_DIR": "C:/Auto_WS/ai-testcase-designer-mcp"
}

Как использовать

1. 🖥️ Откройте Claude Desktop (или любой MCP-совместимый клиент).

2. 📂 Скачайте пример чат-сообщения: sample_chat_message.txt и скопируйте его содержимое.

3. ✉️ Вставьте содержимое в чат и отправьте сообщение: ИИ сгенерирует подробные тестовые сценарии в формате Excel.

4. 💾 Сгенерированные Excel-файлы и журналы сервера сохраняются в вашей папке WORK_DIR.

▶️ Пример запроса

{
  "name": "generate_tests_excel",
  "arguments": {
    "endpoint": "https://api.example.com/v1/users",
    "method": "POST",
    "payload": {
      "name": "John Doe",
      "email": "john@example.com"
    },
    "extraContext": "Focus on invalid email and empty payload scenarios."
  }
}

📊 Пример вывода Excel

📂 Выходные файлы

Файлы записываются в: ./workdir/generated/

Пример вывода журнала

2025-09-13T10:22:11 [info]: [Step1] Incoming request: endpoint=/v1/users, method=POST
2025-09-13T10:22:11 [info]: [Step2] Building LLM prompt...
2025-09-13T10:22:13 [info]: [Step5] Converting LLM JSON to Excel rows (15 test cases)

Отладка

npm run inspector

Inspector предоставит URL для доступа к инструментам отладки в вашем браузере.

Лицензия

Этот проект лицензирован по лицензии MIT.
Подробности см. в файле LICENSE.