DEV Community

Gaytan Mantel
Gaytan Mantel

Posted on

TestSprite MCP Server 快速入门指南（中文翻译）

#mcp #ai #testing #tutorial

TestSprite MCP Server 快速入门指南

本文翻译自 TestSprite 官方文档，旨在帮助中文开发者快速上手 TestSprite MCP Server。

什么是 TestSprite？

TestSprite 是一款面向 AI 原生团队的无代码、无提示词全自动软件测试代理。它的 AI 引擎可以在 10-20 分钟内完成整个测试周期，让你无需手动 QA 即可放心发布。

TestSprite MCP Server 是一个 Model Context Protocol（MCP） 集成方案，将你 IDE 中的 AI 助手（如 Cursor、Windsurf、VS Code 等）与 TestSprite 的智能测试引擎连接起来，在开发环境中实现全自动化测试工作流。

它是如何工作的？

安装 TestSprite MCP 后，你只需在 IDE 中使用自然语言提示，AI 测试代理就会替你完成整个测试流程。

在聊天窗口输入：

Help me test this project with TestSprite.
Enter fullscreen mode Exit fullscreen mode

或将项目文件夹拖入聊天窗口，TestSprite MCP Server 会接管后续所有工作。

8 个简单步骤

  1. 读取用户 PRD — 分析产品需求文档
  2. 分析你的代码 — 扫描项目结构和技术栈
  3. 生成 TestSprite PRD — 将需求转化为测试规格
  4. 创建测试计划 — 自动生成测试用例
  5. 生成测试代码 — 输出可执行的测试脚本
  6. 执行测试 — 在云端运行所有测试
  7. 提供结果 — 生成详细的测试报告
  8. 启用修复 — AI 自动分析并修复发现的问题

核心优势

对开发者

  • 零测试编写 — AI 自动生成所有测试用例
  • 分钟级反馈 — 从小时级缩短到分钟级
  • 自动修复问题 — AI 分析并自动修补 bug
  • 不离开 IDE — 全部在编辑器内完成

对团队

  • 可预测的质量 — 每次发布都有保障
  • 更快的发布速度 — 持续集成无阻塞
  • 全面覆盖 — 包括边界情况和边缘场景
  • 减少手动 QA — 降低测试维护开销

测试能力

类别 能力
前端测试 业务流程 E2E、用户旅程导航、表单验证、视觉状态、交互组件、授权流程、UI 错误处理
后端测试 API 工作流、合约与 Schema 验证、错误处理与弹性、授权认证、边界与边缘情况、数据完整性
安全测试 安全漏洞扫描

支持的技术栈

前端： React、Vue、Angular、Svelte、Next.js、Vite、Vanilla JS/TS

后端： Node.js、Python、Java、Go、Express.js、FastAPI、Spring Boot

API： REST APIs、GraphQL

安装指南

前置条件

  1. 兼容的 IDE — Cursor、Windsurf、VS Code、Trae、Claude Code、GitHub Copilot
  2. TestSprite 账号 — 免费注册
  3. Node.js >= 22 — 下载 Node.js（MCP Server 运行必需）

获取 API Key

  1. 登录 TestSprite 控制台
  2. 进入 Settings → API Keys
  3. 点击 "New API Key"
  4. 复制生成的 API Key

Cursor 安装

一键安装：

  1. 获取 API Key
  2. 点击 一键安装链接
  3. 在 Cursor 中输入 API Key
  4. 开始测试

手动安装：

  1. 打开 Cursor Settings（⌘⇧J）
  2. 进入 Tools & Integration
  3. 点击 Add custom MCP
  4. 添加以下配置： 
{
  "mcpServers": {
    "TestSprite": {
      "command": "npx",
      "args": ["@testsprite/testsprite-mcp@latest"],
      "env": {
        "API_KEY": "your-api-key"
      }
    }
  }
}
Enter fullscreen mode Exit fullscreen mode
  1. 检查 TestSprite MCP Server 图标是否显示绿色圆点

Claude Code 安装

在项目目录终端中运行：

claude mcp add TestSprite --env API_KEY=your_api_key -- npx @testsprite/testsprite-mcp@latest
Enter fullscreen mode Exit fullscreen mode

验证安装：

claude mcp list
# 应显示: TestSprite: npx @testsprite/testsprite-mcp@latest - ✓ Connected
Enter fullscreen mode Exit fullscreen mode

VS Code 安装

  1. 打开命令面板（⌘⇧P）
  2. 运行 MCP: Add Server
  3. 选择 Command (stdio) 安装类型
  4. 输入 npx @testsprite/testsprite-mcp@latest
  5. 输入名称 TestSprite
  6. 选择配置范围
  7. 添加环境变量： 
{
  "servers": {
    "testsprite": {
      "command": "npx",
      "args": ["-y", "@testsprite/testsprite-mcp@latest"],
      "env": {
        "API_KEY": "your-api-key"
      }
    }
  }
}
Enter fullscreen mode Exit fullscreen mode

运行你的第一个测试

第 1 步：准备项目

确保你的应用在本地运行：

# 前端应用
npm run dev          # 通常运行在 3000、5173 或 8080 端口

# 后端应用
node index.js        # 通常运行在 8000、3001 或 4000 端口
Enter fullscreen mode Exit fullscreen mode

第 2 步：执行魔法命令

在 IDE 聊天窗口中输入：

Can you test this project with TestSprite?
Enter fullscreen mode Exit fullscreen mode

也可以将项目文件夹拖入聊天窗口。

第 3 步：配置测试参数

根据提示选择：

  • 测试类型： Frontend（前端 UI）或 Backend（API 服务）
  • 测试范围： Codebase（全量）或 Code Diff（仅未提交的变更）
  • 测试账号： 如需登录，提供用户名和密码
  • 应用 URL： 前端地址（如 http://localhost:5173）和后端地址（如 http://localhost:4000）

第 4 步：自动化工作流

TestSprite 会自动完成以下流程：

  • 读取并分析代码
  • 生成产品需求文档（PRD）
  • 创建测试计划
  • 生成测试代码
  • 在云端执行测试

第 5 步：查看测试结果

测试完成后，结果会保存在 testsprite_tests/ 目录：

testsprite_tests/
├── tmp/
│   ├── prd_files/                 # 上传的 PRD 文件
│   ├── config.json               # 测试配置
│   ├── code_summary.json         # 代码分析
│   ├── report_prompt.json        # AI 分析数据
│   └── test_results.json         # 详细测试结果
├── standard_prd.json             # 标准化 PRD
├── TestSprite_MCP_Test_Report.md # 可读报告
├── TestSprite_MCP_Test_Report.html # HTML 报告
├── TC001_Login_Success_with_Valid_Credentials.py
├── TC002_Login_Failure_with_Invalid_Credentials.py
└── ...                           # 更多测试文件
Enter fullscreen mode Exit fullscreen mode

第 6 步：自动修复 Bug

如果测试发现了问题，在聊天窗口中输入：

Please fix the codebase based on TestSprite testing results.
Enter fullscreen mode Exit fullscreen mode

TestSprite 会自动分析失败的测试用例并生成修复补丁。

示例输出

生成的测试计划：

{
  "testCases": [
    {
      "id": "TC001",
      "title": "用户认证登录",
      "description": "使用有效凭证测试用户登录",
      "category": "Functional",
      "priority": "High",
      "steps": [
        "导航到登录页面",
        "输入有效的用户名和密码",
        "点击登录按钮",
        "验证登录成功"
      ]
    }
  ]
}
Enter fullscreen mode Exit fullscreen mode

测试报告摘要：

{
  "summary": {
    "totalTests": 18,
    "passed": 12,
    "failed": 6,
    "passRate": "67%",
    "coverage": "85%"
  }
}
Enter fullscreen mode Exit fullscreen mode

实际效果

  • 90%+ 代码质量 — 达到专业级代码质量标准
  • 10 倍测试提速 — 从小时级缩短到分钟级
  • 零学习曲线 — 无需测试专业知识
  • 自动修复 Bug — AI 自动打补丁

成功技巧

  • 确保应用在本地正常运行后再开始测试
  • 提供测试账号凭证以覆盖登录流程
  • 首次运行选择 "Codebase" 模式进行全面扫描
  • 后续迭代使用 "Code Diff" 模式只测试变更部分
  • 仔细阅读测试报告中的失败用例和修复建议

下一步

本文基于 TestSprite 官方文档翻译，代码示例和变量名保持原文不变。如有疑问请参考 原文。

Top comments (0)