STARWARCLOUD STARWAR.AI
返回市场
人工智能测试用例设计者-MCP

人工智能测试用例设计者-MCP

作者：Mallikarjun-Roddannavar8 星标更新：2025-10-24
安装使用来源：spider==github.com

项目介绍

🤖 AI 测试用例生成器 MCP

这是一个基于模型上下文协议（MCP）的服务器，能够从API端点元数据中直接生成全面的API测试计划（包括正向、负向以及边界/边缘情况），由**大型语言模型（LLMs）**驱动。

这是一个面向QA工程师的TypeScript基础的MCP服务器。它通过提供以下内容来展示核心的MCP概念：

  • 基于AI的工具，可以从API端点和负载中生成详尽的测试用例计划。
  • 通过提示驱动的LLM集成来保证质量和覆盖范围。
  • 可扩展的结构，用于未来的自动化工具。

✨ 特性

  • 🔌 符合MCP标准的服务器（使用stdio传输）。
  • 📝 工具：generate_tests_excel
    • 输入：端点、HTTP方法、负载、额外上下文。
    • 输入选项：
      • 直接端点详情：端点、HTTP方法、负载。
      • 使用额外上下文来提供任何附加的测试说明或约束条件。
    • 输出：📊 包含列序号、测试名称、前置条件、步骤、预期结果的Excel测试计划。
  • 🧠 通过可配置的LLM（如Groq、OpenAI、Anthropic）进行提示驱动的测试生成。
  • 📜 使用Winston进行详细的日志记录。

🏗️ 架构

flowchart TD
    A[Claude / MCP 客户端] -->|运行工具| B[MCP 服务器]
    B -->|提示| C[LLM API]
    C -->|测试用例JSON| B
    B -->|Excel导出| D[(测试计划.xlsx)]
    B -->|日志| E[服务器日志文件]

📂 项目结构

<details> 
ai-testcase-designer-mcp/
├── build/                         # 编译后的JavaScript输出
├── assets/                        # 演示gif、图片和样本文件
│    ├── demo.gif
│    ├── excel_preview.png
│    └── sample_chat_message.txt
├── configs/
│    └── config.json               # 服务器/工具配置
├── src/
│    ├── index.ts                  # 主服务器入口点（MCP接口及路由）
│    ├── excel.ts                  # Excel文件创建与写入逻辑（模块化）
│    ├── logger.ts                 # Winston日志配置及写入（模块化）
│    └── prompts/
│         └── testcase_prompt.txt  # 基于LLM的测试生成提示模板
├── package.json
├── tsconfig.json
├── README.md
└── .gitignore
  • src/excel.ts：处理所有Excel（.xlsx）文件的创建和测试计划导出（模块化）。
  • src/logger.ts：在整个MCP服务器中提供模块化的日志功能，使用Winston。
  • src/prompts/：包含用于LLM驱动测试生成的提示模板。
  • assets/：演示GIF、Excel样本预览和聊天提示示例。
</details>

🎥 演示

这是MCP生成测试用例并导出到Excel的过程：

AI 测试用例设计器演示

🔍 Excel 预览

以下是生成的测试用例快速预览：

Excel 预览

开发

安装依赖项：

npm install

构建服务器：

npm run build

开发时自动重建：

npm run watch

⚙️ 安装

按照以下步骤在本地设置AI测试用例设计器MCP服务器：

  1. 克隆仓库

    git clone https://github.com/yourusername/ai-testcase-designer-mcp.git
cd ai-testcase-designer-mcp

  2. 安装依赖项

    npm install

  3. 构建服务器

    npm run build

  4. 在您的MCP客户端中配置服务器

    a. Claude Desktop或其他兼容MCP的客户端

    <details>

    • 添加以下服务器配置：

      • 在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"
    }
  }
}
    </details>

    b. Cline（VS Code扩展）

    <details> 您也可以使用AI测试用例设计器MCP服务器与[Cline](https://cline.bot)，这是一个Model Context Protocol的VS Code扩展。

    快速开始：

    1. 从VS Code市场安装Cline。
    2. 打开Cline侧边栏（从VS Code活动栏）。
    3. 转到“MCP服务器”部分并点击“添加新MCP服务器”。
    4. 填写服务器详细信息： 
      {
  "mcpServers": {
    "ai-testcase-designer-mcp": {
      "disabled": false,
      "timeout": 120,
      "command": "node",
      "args": [
        "c:/Auto_WS/ai-testcase-designer-mcp/build/index.js"
      ],
      "transportType": "stdio"
    }
  }
}
    5. 测试连接并保存。

    详细的步骤图解如下：

    Cline MCP服务器添加步骤

    Cline MCP服务器连接成功

    更详细的Cline指导，请参阅官方文档： cline.bot/getting-started/installing-cline#vs-code-marketplace%3A-step-by-step-setup

</details>

🔑 API密钥及工作目录设置

要使用AI测试用例设计器MCP。

  1. 从这里免费获取您的Groq API密钥：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. ✉️ 将内容粘贴到聊天框并发送消息：AI将生成详细的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": "关注无效邮箱和空负载场景。"
  }
}

📊 示例Excel输出

<details>
序号测试名称前置条件步骤预期结果
1创建有效用户数据库为空发送带有有效负载的POST请求用户创建成功
2缺少邮箱数据库为空发送仅包含名字的POST请求400验证错误
3无效邮箱数据库为空发送带有无效邮箱格式的POST请求422错误消息
</details>

📂 文件输出

文件写入到：./workdir/generated/

样本日志输出

<details> 
2025-09-13T10:22:11 [info]: [Step1] 接收到请求：endpoint=/v1/users, method=POST
2025-09-13T10:22:11 [info]: [Step2] 构建LLM提示...
2025-09-13T10:22:13 [info]: [Step5] 将LLM JSON转换为Excel行（15个测试用例）
</details>

调试

<details> 由于MCP服务器通过stdio通信，调试可能会比较困难。我们推荐使用作为包脚本提供的[MCP Inspector](https://github.com/modelcontextprotocol/inspector)： 
npm run inspector

Inspector将提供一个URL，您可以在浏览器中访问调试工具。

</details>

许可证

此项目根据MIT许可证发布。 详见LICENSE文件。