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 分

    請在儲存庫或註冊中心條目中宣告授權條款。