使用说明
测试报告器MCP服务器
MCP（模型上下文协议）服务器 测试台账 这使Claude Code能够分析不稳定的测试，发现故障模式，提出修复建议等等。
安装
无需安装！只需将配置添加到Claude代码中即可。
快速开始
1.获取API密钥
登录 testledger.dev 然后转到“设置”→ 生成密钥的API密钥。
2.配置克劳德代码
将此添加到您的Claude Code MCP配置中：
地点： ~/.claude.json （全球）或 .mcp.json （项目）
{
"mcpServers": {
"test-reporter": {
"command": "npx",
"args": ["-y", "@testledger/mcp@latest"],
"env": {
"TEST_LEDGER_API_KEY": "your-api-key-here"
}
}
}
}
提示： 使用
@latest确保您始终获得包含错误修复的最新版本。
3.重新启动克劳德代码
就是这样！Claude Code现在可以访问您的测试结果。
用法
配置后，您可以向Claude Code询问以下内容：
- “为什么
checkout.spec.js片状？" - “本周哪些测试失败最多？”
- “显示最近的测试失败”
- “是否有任何测试总是一起失败？”
使用/fix flaky测试命令
为了获得最佳体验，请添加 修复片状测试斜线命令 对于您的项目：
mkdir -p .claude/commands
curl -o .claude/commands/fix-flaky-test.md https://raw.githubusercontent.com/your-company/test-reporter-mcp/main/commands/fix-flaky-test.md
然后使用它：
/fix-flaky-test
Test: LoginPage.should allow user to login with valid credentials
Error: element ("#submit-btn") still not clickable after 3000ms
at login.spec.js:42:24
可用工具
MCP服务器为Claude提供以下工具：
| 工具 | 说明 |
|---|---|
get_test_history |
测试的通过/失败/不稳定统计数据 |
get_failure_patterns |
一天中的时间、浏览器和版本模式 |
get_correlated_failures |
一起失败的测试（共享设置问题） |
get_flaky_tests |
项目范围内的测试排行榜 |
get_recent_failures |
最近快速分流失败 |
get_test_trend |
随时间变化的故障率 |
配置选项
| 环境变量 | 必填 | 说明 |
|---|---|---|
TEST_LEDGER_API_KEY |
是 | 仪表板中的API密钥 |
TEST_LEDGER_API_URL |
否 | 自定义API URL（默认值： https://app-api.testledger.dev) |
TEST_LEDGER_PROJECT_ID |
否 | 用于查询的默认项目ID |
所有选项示例
{
"mcpServers": {
"test-reporter": {
"command": "npx",
"args": ["-y", "@testledger/mcp"],
"env": {
"TEST_LEDGER_API_KEY": "tr_live_abc123",
"TEST_LEDGER_PROJECT_ID": "42"
}
}
}
}
故障排除
“找不到工具”错误
- 更新配置后重新启动Claude代码
- 检查配置文件中的JSON语法错误
- 验证您的API密钥是否有效
“API错误401”
您的API密钥无效或已过期。从仪表板生成一个新的。
“API错误403”
您的API密钥无权访问请求的项目。检查项目权限。
支持
- 文档： testledger.dev
- 问题： GitHub问题
