Tesults Mcp

io.github.tesults由 GitHub 账号 tesults 发布v1.1.0更新于 Oct 25, 2026

Ask your AI agent why your tests are failing. Instant analysis on failures and regressions.

已验证STDIO仅桌面开发者工具数据与分析

概览

AI 生成的概览

把 AI 助手连接到 Tesults 测试结果，可列出目标、查看运行记录，并解释失败、回归和不稳定测试。

可以做什么
  • 列出、创建、更新和删除目标（测试任务），并重新生成目标的 API 令牌
  • 获取某个目标的测试结果，包括通过/失败计数的运行记录和单个测试用例
  • 用通俗语言解释某次运行：摘要、可能原因、未通过数量和主要失败模式
  • 在最近多次运行中查找不稳定测试，并比较运行以区分新增、已解决和持续失败
  • 根据测试用例近期历史给出稳定性分类、趋势、模式和修复建议
适用场景
适合把测试结果存放在 Tesults 的团队，让助手在对话中诊断失败的 CI 运行、发现回归和不稳定测试，或管理测试目标。
运行要求
通过 stdio 在本机运行，通常用 npx 从 npm 包启动。需要在 TESULTS_API_TOKEN 环境变量中提供 Tesults API 令牌，可从 Tesults 项目配置获取。可选设置 TESULTS_READ_ONLY=true 以仅暴露报告类工具。需要访问 Tesults 的网络连接。
安装前请注意
该令牌拥有账号的 API 权限，请妥善保密。创建、更新、删除目标以及重新生成令牌都是写入操作：删除不可撤销并会移除全部测试结果，重新生成令牌会让使用旧令牌的 CI/CD 流水线立即失效。只读模式只是本服务器的限制，并不缩减令牌权限；洞察类工具仍可能在服务器端生成并缓存 AI 分析。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Tesults Mcp，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

tesults-mcp

Tesults MCP server. Connect AI agents and MCP-compatible tools to your Tesults test results, insights, and targets.

Documentation

Full setup and usage documentation: https://www.tesults.com/docs/api/mcp

Quick start

claude mcp add tesults-mcp npx tesults-mcp -e TESULTS_API_TOKEN=your-api-token

Reporting-only mode

Set TESULTS_READ_ONLY=true in the MCP server's environment alongside TESULTS_API_TOKEN. This exposes only the seven reporting and insight tools. Target creation, editing, deletion and token regeneration are not registered, and non-GET API requests are blocked locally.

Existing configurations remain unchanged when this setting is omitted or false. This is a restriction in this MCP server, not a reduction in the API token's permissions. Keep the token private. Insight tools can still generate and cache AI analyses on the server; they do not change your test results or targets.

Requests time out after 60 seconds and responses are limited to 10 MiB. For large result sets, request fewer runs or use cases=false for summaries. API failures are returned as tool errors, not successful answers.

These options apply to this source version and require an updated installation once released. They do not change an already installed published package.

Offline checks

Run node --test tests/hardening.test.js. Tests do not call Tesults or use a real token.

License

MIT

来源：README.md，提交 7798be8

工具

11

tesults_get_targets

List all targets (test jobs) in the Tesults project. Returns target ids and names needed by other tools.

输入参数limitcursor

tesults_create_target

Create a new target (test job) in the Tesults project. Returns the created target and its API token.

输入参数name必填groupdescription

tesults_update_target

Update an existing target. Any combination of name, description, or group can be updated.

输入参数namegrouptarget必填description

tesults_delete_target

Permanently delete a target and all its test results. This action cannot be undone.

输入参数target必填

tesults_regenerate_token

Regenerate the API token for a target. The existing token will stop working immediately. Any CI/CD pipelines using the old token must be updated.

输入参数target必填

tesults_get_results

Get test results for a target. Returns test runs with pass/fail counts and individual test cases.

输入参数runbuildcaseslimitcursortarget必填analysispersistent

tesults_explain_run

Get a plain-language explanation of a specific test run: summary, likely causes, non-passing count, and key failure patterns. Causes are hypotheses, not verified facts. Analysis covers at most 100 non-passing tests; check truncation metadata.

输入参数run必填target必填

tesults_get_flaky_tests

Find inconsistent interpreted results across at most 10 recent runs in the requested range, including pass/unknown transitions. Returns failure rate and classification; an empty list is limited to this window, not proof of long-term stability.

输入参数tofromtarget必填

tesults_get_regressions

Compare the latest run with its immediately preceding run. Distinguishes new failures from continuing failures. Not a comparison against the last passing run or a historical baseline.

输入参数target必填

tesults_what_changed

Compare a specific run against the previous run. Returns resolved failures, new failures, and continuing failures.

输入参数run必填target必填

tesults_explain_case

Get stability classification, trend, patterns, and recommendations from a test case's recent history. This is not scoped to a historical selected run. Interpret conclusions within the returned runs_analyzed count.

输入参数case必填target必填

版本历史

2
  1. v1.1.0最新Oct 25, 2026
  2. v1.0.2Sep 16, 2026

评分

已满足适用检查项的 80%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分
  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

    请在仓库或注册中心条目中声明许可证。