🤖 AI测试用例生成器 MCP
一 模型上下文协议（MCP）服务器 那能产生全面的 API测试计划 （正面、负面和边界/边缘情况）直接从终端元数据中获取——由……驱动 大型语言模型（LLMs）。
这是一个基于TypeScript的模型上下文协议（MCP）服务器，专为问答（QA）工程师设计。它通过提供以下内容来展示模型上下文协议的核心概念：
- 基于API端点和有效载荷的AI驱动工具，用于生成详尽的测试用例计划
- 基于提示的大型语言模型（LLM）集成，以提升质量和覆盖范围
- 为未来自动化工具预留的可扩展结构
✨ 特点
- 🔌（电源插头） 符合MCP标准的服务器 (
stdio（交通）。 - 📝 工具：
generate_tests_excel
- 输入：终端点（或端点）、HTTP方法、有效载荷、额外上下文。 - 输入选项： - 直接终端详细信息端点，HTTP方法，有效载荷 - 使用extraContext来提供任何额外的测试说明或限制条件 - 输出输出（注：原文“OutputPut”可能是“Output”与“Put”的组合，但在此上下文中，“Output”已足够表达“输出”的意思，因此译文简化为“输出输出”，但实际上仅需翻译为“输出”即可，若需强调动作的重复或特定语境下的表达，可保留“输出输出”）📊 Excel测试计划 包含以下列： *序号，测试名称，前提条件，步骤，预期结果*。
- 🧠 表示“大脑”或“思考”。 提示驱动的测试生成 支持可配置的大型语言模型（Groq、OpenAI、Anthropic）。
- 📜 详细的日志记录，使用 温斯顿。
🏗️ 建筑学
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.ts（或“源代码/Excel.ts”，具体翻译可能根据上下文有所调整，但“src”通常表示源代码目录，“excel.ts”表示一个处理Excel文件的TypeScript文件）处理所有Excel（.xlsx）文件的创建和测试计划导出（模块化）。
- src/logger.ts 翻译为中文是：源代码目录下的日志记录器文件（或“日志工具文件”）使用Winston为MCP服务器提供模块化的日志记录功能。
- src/prompts/（可翻译为）源代码目录下的提示文件夹/包含用于大型语言模型（LLM）驱动的测试生成的提示模板。
- 资产/演示GIF、Excel样本预览以及聊天提示示例。
______________________________________________________________________
🎥 演示
以下是MCP生成测试用例并导出到Excel的过程：
🔍 Excel 预览
以下是生成的测试用例的快速预览：
发展
安装依赖项：
npm install构建服务器：
npm run build对于支持自动重建的开发：
npm run watch⚙️ 安装
按照以下步骤在本地设置AI测试用例设计器MCP服务器：
- 克隆仓库
git clone https://github.com/yourusername/ai-testcase-designer-mcp.git
cd ai-testcase-designer-mcp- 安装依赖项
npm install- 构建服务器
npm run build- 在您的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 扩展）
You can also use the AI Testcase Designer MCP server with Cline, the Model Context Protocol VS Code extension.
快速入门：
1. 安装 来自VS Code市场的Cline（扩展/插件）。 1. 打开Cline侧边栏 （来自 VS Code 的活动栏）。 1. 前往“MCP 服务器”部分，然后点击“添加新的 MCP 服务器”。 1. 填写服务器详细信息：
{
"mcpServers": {
"ai-testcase-designer-mcp": {
"disabled": false,
"timeout": 60,
"command": "node",
"args": [
"c:/Auto_WS/ai-testcase-designer-mcp/build/index.js"
],
"transportType": "stdio"
}
}
}1. 测试连接并保存。
如需分步视觉指南，请参见下文：
Cline MCP Server Connection Success
如需详细的 Cline 指南，请参阅官方文档：\ cline.bot/入门指南/安装cline#VS代码市场：分步设置
🔑 API密钥与工作目录设置
使用AI测试用例设计器MCP。
- 从这里免费获取您的Groq API密钥： https://console.groq.com/keys 翻译为中文是：“https://console.groq.com/密钥（或‘API密钥’）”。不过，具体翻译可能根据网站的实际内容和语境有所调整，但“密钥”或“API密钥”是较为通用的翻译
- 一个工作目录（WORK_DIR），用于保存生成的Excel测试计划和服务器日志。
更新您的 config.json 像这样的文件：
{
"MODEL_API_KEY": "gsk_7Ma3Fabcd ",
"WORK_DIR": "C:/Auto_WS/ai-testcase-designer-mcp"
}如何使用
- 🖥️ 打开Claude桌面版（或任何兼容MCP的客户端）。
- 📂（文件夹） 下载示例聊天信息： sample_chat_message.txt 翻译为中文是：“示例聊天消息.txt” 并复制其内容。
- 将内容粘贴到聊天框中并发送消息：AI 将生成 Excel 格式的详细测试用例。
- 💾 生成的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输出示例
| 序号 | 测试名称 | 前置条件 | 步骤 | 预期结果 |
|---|---|---|---|---|
| 1 | 有效用户创建 | 数据库为空 | 发送包含有效有效载荷的POST请求 | 用户创建成功 |
| 2 | 缺少电子邮件 | 数据库为空 | 仅发送包含姓名的POST请求 | 400验证错误 |
| 3 | 无效电子邮件 | 数据库为空 | 发送格式无效的电子邮件的POST请求 | 422错误消息 |
📂 文件输出
文件被写入到：./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)调试
Since MCP servers communicate over stdio, debugging can be challenging. We recommend using the MCP Inspector, which is available as a package script:
npm run inspector检查员将提供一个URL，以便您在浏览器中访问调试工具。
许可证
这个项目遵循MIT许可证授权。\ 看看 许可证 详情见文件。