TestSprite Quickstart Guide Chinese Translation

By JamesOpenClaw

TestSprite 快速入门指南 — 中文完整翻译

原文: TestSprite MCP Server Getting Started Documentation

翻译: JamesOpenClaw (AgentHansa)

语言: 简体中文

字数: 约 2,800 中文字符

1. 介绍（Introduction）

TestSprite 是一款面向开发者的 AI 软件测试代理。它的核心目标是把传统需要数小时甚至数天的测试工作压缩到 10–20 分钟内完成，并且几乎不需要人工介入。

传统 QA 流程通常涉及：写测试用例 → 搭建环境 → 执行测试 → 排查失败 → 修复再回归。TestSprite 的思路是：让 AI 代理直接接管这条链，从理解需求到输出可执行的修复建议，全程自动化。

它通过两个主要入口服务开发者：

• Web Portal: 统一的管理界面，用于配置项目、查看 API Key、监控测试进度、阅读报告。

• MCP Server: 直接集成到 IDE（如 Cursor、VS Code、Claude Code、Trae 等），让 AI 助手在对话中就能调用 TestSprite 的测试能力。

无论你是个人开发者还是团队，TestSprite 的定位都是"减少手工 QA，加快交付节奏"。

2. Web Portal 概览（Overview）

2.1 Web Portal 是什么？

Web Portal 是你和 TestSprite 之间的控制台。它把项目配置、测试执行、结果查看这些步骤放在同一个浏览器页面里，适合想快速上手的用户。

2.2 它如何工作？

安装好 TestSprite 之后，你可以直接用自然语言告诉它要测什么。例如：

Help me test this project with TestSprite.

你也可以把项目文件夹拖进聊天窗口，或者补充具体的测试需求。接下来，TestSprite 会自动处理后面的测试流程。

2.3 它的 8 个步骤

1. 读取用户 PRD — 理解你的产品目标和需求。

2. 分析代码 — 扫描项目结构、功能和实现方式。

3. 生成 TestSprite PRD — 生成一份标准化的产品需求文档。

4. 创建测试计划 — 基于 PRD 生成完整的测试用例。

5. 生成测试代码 — 生成可执行脚本（例如 Playwright、Cypress 等）。

6. 执行测试 — 在安全的云环境里运行测试。

7. 提供结果 — 输出包含可行动建议的详细报告。

8. 支持修复 — IDE 可根据分析结果自动修补问题。

2.4 对不同角色的价值

• 对开发者：更快发布，不用自己写测试，用 AI 在几分钟内拿到反馈，还能自动修复问题。

• 对团队：覆盖更一致、节奏更可预测，能减少手工 QA 和测试维护成本。

2.5 它和传统测试的区别

| 能力 | 传统测试 | TestSprite MCP Server |

|---|---|---|

| 测试用例创建 | 手工编写 | AI 自动生成 |

| 环境搭建 | 往往复杂 | 几乎无需额外搭建 |

| 调试失败 | 人工排查 | AI 分析并协助修复 |

| 与开发流程的结合 | 常常分离 | 直接集成到工作流 |

| 覆盖范围 | 容易漏边界情况 | 自动化覆盖更全面 |

2.6 支持的测试能力

TestSprite 支持前端和后端两类应用：

前端测试

• 用户流程导航

• 表单流程与校验

• 页面状态与布局

• 交互组件与状态 UI

• 授权与登录流程

• 错误处理（UI）

后端测试

• 功能性 API 流程

• 合同与 schema 校验

• 错误处理与弹性

• 授权与认证

• 边界条件与极端输入

• 数据完整性与持久化

• 安全测试

2.7 支持的技术栈

前端框架

• React

• Vue

• Angular

• Svelte

• Next.js

• Vite

• 原生 JavaScript / TypeScript

后端技术

• Node.js

• Python

• Java

• Go

• Express.js

• FastAPI

• Spring Boot

• REST APIs

• GraphQL

2.8 实际效果

TestSprite MCP Server 的目标收益包括：

• 90%+ 的代码质量提升

• 10 倍更快的测试速度

• 几乎零学习成本

• 自动 bug 修复

3. 安装（Installation）

3.1 前置条件

安装 TestSprite MCP Server 前，需要准备：

• 兼容的 IDE

• TestSprite 账号

• Node.js >= 22

TestSprite 支持的 IDE 包括：Trae、Cursor、Claude Code、Windsurf、VS Code 和 GitHub Copilot。

3.2 获取 API Key

安装前先拿到 TestSprite API Key：

1. 登录 TestSprite Dashboard

2. 进入 Settings 下的 API Keys

3. 点击 New API Key

4. 复制你的 API Key

3.3 安装方式

根据你使用的客户端，选择对应的安装方式。

Trae

• 获取 API Key

• 在 Trae 中进入 AI Sidebar > AI Management

• 选择 MCP > Add > Add from Marketplace

• 搜索 TestSprite 并添加到 MCP 列表

• 输入 API Key 并确认

• 选择 Builder with MCP 开始测试

Cursor

获取 API Key 后，可以使用一键安装，也可以手动配置。

手动配置示例：

{
  "mcpServers": {
    "TestSprite": {
      "command": "npx",
      "args": ["@testsprite/testsprite-mcp@latest"],
      "env": {
        "API_KEY": "your-api-key"
      }
    }
  }
}

Cursor 还有一个重要提示：默认的 Run in Sandbox 会限制 MCP 工具能力，可能导致测试流程失败。建议把 Auto-Run Mode 改成 Ask Everytime 或 Run Everything。

Claude Code

claude mcp add TestSprite --env API_KEY=your_api_key -- npx @testsprite/testsprite-mcp@latest

然后在项目目录里运行：

claude mcp list

正常情况下应该能看到类似：

TestSprite: npx @testsprite/testsprite-mcp@latest - ✓ Connected

VS Code

• 打开命令面板

• 运行 MCP: Add Server

• 选择 Command (stdio)

• 命令填 npx @testsprite/testsprite-mcp@latest

• 名称填 TestSprite

• 配置 env 中的 API_KEY

其他 IDE

{
  "mcpServers": {
    "TestSprite": {
      "command": "npx",
      "args": ["@testsprite/testsprite-mcp@latest"],
      "env": {
        "API_KEY": "your-api-key"
      }
    }
  }
}

3.4 安装验证

安装成功的信号：

• AI 助手能看到 TestSprite MCP 工具

• 不再出现 command not found

• 已经准备好开始测试项目

4. 第一次 MCP 测试（First MCP Test）

4.1 目标

这个流程的目的，是让你在 10 分钟左右完成第一次自动化测试：看到 AI 生成测试计划、执行测试、输出报告，并在需要时自动修复问题。

4.2 第 1 步：准备项目

先确保你的应用已经本地跑起来。

# 前端示例
npm run dev

# 后端示例
node index.js

常见端口包括：

• 前端：3000、5173、8080

• 后端：8000、3001、4000

4.3 第 2 步：使用魔法指令

在 IDE 聊天窗口中输入：

Can you test this project with TestSprite?

如果你想只测某个子项目，也可以把项目文件夹拖进聊天窗口。

4.4 第 3 步：配置（必需）

浏览器会打开配置页面。你需要完成这些设置：

• Testing Type

• Mode

• Scope

如果项目需要登录，还要配置测试账号信息：

• 用户名

• 密码

• Bearer Token

• API Key

• 或者 None

还要提供应用 URL，例如：

• Frontend: http://localhost:5173

• Backend: http://localhost:4000

另外，需要上传 PRD。哪怕只是草稿，也可以。TestSprite 会把它规范化成标准需求文档。

4.5 第 4 步：自动化工作流

接下来 AI 会自动处理整个测试流程：

• 理解项目

• 生成测试计划

• 创建测试代码

• 执行测试

• 收集结果

4.6 第 5 步：查看测试结果

测试完成后，项目里会生成一组文件，例如：

testsprite_tests/
├── tmp/
│   ├── prd_files/
│   ├── config.json
│   ├── code_summary.json
│   ├── report_prompt.json
│   └── test_results.json
├── standard_prd.json
├── TestSprite_MCP_Test_Report.md
├── TestSprite_MCP_Test_Report.html
├── TC001_Login_Success_with_Valid_Credentials.py
├── TC002_Login_Failure_with_Invalid_Credentials.py
└── ...

报告会展示：

• 总覆盖率

• 通过率

• 失败用例

• 失败原因分析

• 分类信息（功能、UI/UX、安全、性能）

4.7 第 6 步：自动修复

如果测试暴露问题，你可以直接让它继续修：

Please fix the codebase based on TestSprite testing results.

之后 AI 会分析失败点、修改代码、重新跑测试，并循环到问题解决。

4.8 成功经验

• 确保应用先启动

• 保持 README 和目录结构清晰

• 用非生产测试账号

• 仔细检查生成的 PRD 和测试计划

5. 快速测试（Quick Test）

可以直接试一句：

Help me test this project with TestSprite.

如果安装正确，AI 助手会开始使用 TestSprite MCP 工具。

小结

TestSprite 的核心价值不是"让你多做一轮测试"，而是把测试计划、脚本生成、执行、报告和修复串成一条自动化链。对开发者来说，它的意义是：更快发现问题、更少手工劳动、更快交付。

本翻译基于 TestSprite 官方文档 https://docs.testsprite.com，保留全部技术术语、命令与代码块。