Currents

官方

讓 AI 代理修復回報給 Currents 的 Playwright 測試失敗。

你可以用 Currents MCP 做什麼?

  • 診斷 CI 失敗 — 使用 currents-get-context 擷取執行作業、規格檔案或單一測試中失敗測試背後的錯誤、步驟和檔案。
  • 檢視執行作業與結果 — 列出並篩選專案執行作業,然後擷取執行作業詳細資料、規格執行個體結果,以及依簽章查詢的歷史測試結果。
  • 找出不穩定與緩慢的測試 — 查詢測試和規格檔案的效能指標,以及指定日期範圍內彙總的錯誤趨勢。
  • 管理隔離動作 — 建立、啟用、停用或刪除動作,並列出受其影響的測試和執行作業。
  • 收集測試證據 — 從 CI 執行作業收集螢幕截圖、影片、追蹤記錄和附件,或建立可分享的追蹤連結。
  • 管理 Webhook 和 Jira — 列出、建立、更新或刪除專案 Webhook,並從執行作業中的測試建立或連結 Jira 議題。

文件

Currents MCP Server

Unit Tests

讓您的 AI 程式碼代理全面掌握 CI 測試結果。Currents MCP Server 可將 Cursor 和 Claude 等工具直接連接至您的 Currents 儀表板,讓代理無須離開編輯器,就能診斷不穩定的測試、找出失敗原因,並根據實際執行資料採取行動。

  • 查詢 CI 中的執行記錄、規格檔案和個別測試結果
  • 掌握整個測試套件的錯誤趨勢和效能指標
  • 以程式方式管理隔離規則、webhook 和專案設定
  • 讓代理根據實際測試輸出而非猜測,修復問題

Install MCP Server

工具

工具說明
currents-list-actions列出專案的所有動作,並可選擇篩選條件。
currents-create-action為專案建立新動作。
currents-get-action依 ID 取得單一動作。
currents-update-action更新現有動作。
currents-delete-action刪除(封存)動作。
currents-enable-action啟用已停用的動作。
currents-disable-action停用已啟用的動作。
currents-list-affected-tests列出專案在指定日期範圍內受動作(隔離、略過、標記)影響的測試。
currents-get-affected-test-executions以測試為索引:列出指定日期範圍內某個動作套用到的單一測試執行項目,以及各項目的執行、分支和提交。
currents-get-action-executions以動作為索引:列出指定日期範圍內某條規則套用到的測試執行項目,涵蓋其影響的所有測試。
currents-get-projects取得 Currents 平台上可用的專案。
currents-get-project依 ID 取得單一專案。
currents-get-project-insights取得專案在指定日期範圍內彙總的執行和測試指標。
currents-list-pull-requests列出專案的提取要求卡片(依 meta.pr.id 分組的執行)。
currents-list-project-terms列出單一類型(tag、branch、authorName 等)的游標分頁專案詞彙。
currents-create-jira-issue使用組織的 Jira 整合,從執行中的測試建立 Jira 議題。
currents-link-jira-issue使用組織的 Jira 整合,將現有 Jira 議題連結至執行中的測試。
currents-list-jira-projects列出組織整合可用的 Jira 專案。
currents-list-jira-issue-types列出 Jira 專案的議題類型和自訂欄位。
currents-get-runs取得特定專案的執行清單,並可選擇篩選條件。
currents-get-run-details取得一次執行:其狀態、提交、分支、群組和規格檔案(各自包含 instanceId),以及該次執行依層級、類型和來源(attachmentCounts)分類的檔案數量。
currents-find-run依查詢參數尋找一次執行。
currents-cancel-run取消進行中的執行。
currents-reset-run重設執行中失敗的規格檔案,以允許重新執行。
currents-delete-run刪除一次執行及其所有相關資料。
currents-cancel-run-github-ci依 GitHub Actions 工作流程執行 ID 和嘗試次數取消一次執行。
currents-get-spec-instance依 instanceId 擷取一個 spec 檔案執行的原始結果:每個測試的狀態和嘗試次數,以及成品 URL。
currents-get-spec-files-performance擷取特定專案在指定日期範圍內的 spec 檔案效能指標。
currents-get-tests-performance擷取特定專案在指定日期範圍內的彙總測試指標。
currents-get-tests-signatures根據專案、spec 檔案路徑和測試標題產生唯一的測試簽章。
currents-get-test-results擷取特定測試簽章的歷史測試執行結果。
currents-get-context若要找出測試在 CI 中失敗的原因或修正測試,請先呼叫此項目:傳回一次執行、一個 spec 檔案(instance)或單一測試中失敗測試的錯誤、步驟和檔案,內容與 Currents 儀表板中的 Fix 相同。
currents-get-errors-explorer取得專案在指定日期範圍內的彙總錯誤指標。
currents-get-test-evidence收集 CI 執行中測試產生的證據成品(螢幕截圖、影片、追蹤記錄、附件),並提供依測試分組的簽署下載 URL。
currents-create-evidence-links建立可分享的追蹤記錄 API 連結,以提供測試嘗試的證據;內容取自其 Playwright 追蹤記錄,並附上相關 URL:說明該次嘗試執行內容及失敗原因的 Markdown 追蹤摘要(digest URL)、影片縮圖列、動畫螢幕錄影、DOM 快照、網路請求和附件。
currents-create-session將你操作的瀏覽器工作階段記錄為 Currents 工作階段,以便讀取和分享其證據。
currents-add-attachments將附件新增至 currents-create-session 建立的工作階段(傳送 sessionId),或新增至 CI 執行(傳送 runId):可附加 spec 檔案、測試或執行本身的記錄。
currents-list-webhooks列出專案的所有 webhook。
currents-create-share-link建立測試結果的公開連結,任何人都能在連結到期前免登入開啟。purpose "fix" 提供失敗情境,供修正測試的代理程式使用;內容與 currents-get-context 相同,並包含標記為 flaky 的不穩定測試。purpose "report" 會列出每個測試及其嘗試次數和檔案,供人員查看;若為工作階段,則會顯示工作階段頁面:狀態、錯誤、附件和追蹤記錄。
currents-create-webhook為專案建立新的 webhook。
currents-get-webhook依 ID 取得單一 webhook。
currents-update-webhook更新現有的 webhook。
currents-delete-webhook刪除 webhook。

技能

教導 AI 代理執行多步驟 Currents 工作流程的代理技能。

技能說明
browser-evidence實驗性:在沒有可執行測試的情況下,透過親自操作瀏覽器證明變更有效。
collect-evidence透過 Currents 中 CI 執行的測試結果,展示你實作的工作確實有效,或進行示範 — 提供 trace API 連結,其 trace 摘要、filmstrip 和無障礙快照會顯示在留言中,並附上螢幕截圖、附件和影片。
fix-failing-tests使用 Currents 記錄的結果修復 CI 中失敗的測試 — 包括錯誤、步驟、trace、螢幕截圖和主控台輸出。

伺服器會將每項技能發布為 MCP 資源,因此已連線的代理可以 列出並讀取這些資源,無須本機副本:

skill://currents/collect-evidence/SKILL.md
skill://currents/collect-evidence/references/instrumentation.md

只從磁碟載入技能的代理仍需要副本 — 將技能 目錄放到代理的技能位置(例如 Claude Code 的 .claude/skills/)。

設定

API 金鑰

依照此處的指示取得 Currents API 金鑰。

搭配 Cursor 使用

  1. 前往 Cursor Settings > MCP > Enable
  2. 將以下內容新增至你的 mcp.json。
{
  "mcpServers": {
    "currents": {
      "command": "npx",
      "args": ["-y", "@currents/mcp"],
      "env": {
        "CURRENTS_API_KEY": "your-api-key"
      }
    }
  }
}

Claude

執行此命令,將 Currents MCP 新增至 Claude Code

claude mcp add --transport stdio currents --env CURRENTS_API_KEY=<KEY> -- npx -y @currents/mcp

新增以下內容,以在 Claude Desktop 啟用 Currents MCP(編輯 claude_desktop_config.json 檔案):

{
  "mcpServers": {
    "currents": {
      "command": "npx",
      "args": ["-y", "@currents/mcp"],
      "env": {
        "CURRENTS_API_KEY": "your-api-key"
      }
    }
  }
}

VS Code 和 GitHub Copilot

在 VS Code 中安裝會新增託管伺服器。VS Code 首次連線時會開啟 Currents 登入頁面;無須輸入 API 金鑰。

若要安裝外掛程式,同時新增技能和伺服器:

  • VS Code:開啟 vscode://chat-plugin/install?source=currents-dev/currents-mcp

  • Copilot CLI:

    copilot plugin marketplace add currents-dev/currents-mcp
    copilot plugin install currents@currents
    

若只要將伺服器新增至 Copilot CLI:

copilot mcp add --transport http currents https://mcp.currents.dev/mcp

遠端(託管)MCP 端點

除了上述本機 stdio 傳輸方式外,同一伺服器也可以作為託管的 Streamable HTTP 端點執行(例如 https://mcp.currents.dev/mcp),供 Claude 網頁版/行動版應用程式等遠端 連接器使用。

託管伺服器不會自行進行任何驗證。每個請求都必須以 Bearer token 傳送 你的 Currents API 金鑰,並將其轉送至 Currents API:

Authorization: Bearer <your-currents-api-key>

用戶端設定範例(遠端連接器):

{
  "mcpServers": {
    "currents": {
      "url": "https://mcp.currents.dev/mcp",
      "headers": {
        "Authorization": "Bearer your-api-key"
      }
    }
  }
}

自行執行 HTTP 伺服器:

# from the mcp-server package
npm run build && PORT=3000 npm run start:http
# or via Docker (serves /mcp, exposes the configured PORT)
docker build -t currents-mcp . && docker run -p 3000:3000 currents-mcp

Node 伺服器使用純 HTTP;TLS 和公開網域會在容器前方的 反向代理/負載平衡器終止。另提供 GET /healthz 端點 供存活狀態檢查使用。

⚠️ 注意

將 AI 工具(例如透過 MCP)連線至 Currents,即表示你授予它們存取 API 金鑰、測試結果和 CI 中繼資料的權限。你有責任審慎評估所使用的 AI 代理或服務,並確保它們安全地處理你的資料。

參考資料