Currents

官方

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

GitHub
19
試用此 MCP贊助

你可以用 Currents MCP 做什麼？

  • 查詢執行與測試結果 — 透過 currents-get-runs 與 currents-get-test-results 詢問最近的 CI 執行或歷史結果。
  • 搭配脈絡診斷失敗 — 使用 currents-get-context 在執行、實例或測試層級取得失敗脈絡，供 AI 除錯。
  • 收集測試證據 — 使用 currents-get-test-evidence 從 CI 執行中擷取螢幕截圖、影片、追蹤與附件。
  • 管理隔離與動作 — 透過 currents-list-actions 與 currents-create-action 列出、建立、更新或停用隔離規則等動作。
  • 管理 Webhook — 使用 currents-list-webhooks 與 currents-create-webhook 列出、建立、更新或刪除專案 Webhook。

文件

Currents MCP 伺服器

Unit Tests

讓您的 AI 編碼代理程式完整掌握 CI 測試結果。Currents MCP 伺服器可將 Cursor 和 Claude 等工具直接連接到您的 Currents 儀表板，讓代理程式能診斷不穩定的測試、 pinpoint 失敗原因，並根據真實的執行資料採取行動——無需離開您的編輯器。

  • 查詢 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-affected-executions列出在指定日期範圍內套用特定動作/規則的測試執行。
currents-get-projects擷取 Currents 平台中可用的專案。
currents-get-project依 ID 取得單一專案。
currents-get-project-insights取得專案在指定日期範圍內的彙總執行和測試指標。
currents-list-pull-requests列出專案的 Pull Request 卡片（依 meta.pr.id 分組的執行）。
currents-list-project-terms列出單一類型（標籤、分支、作者名稱等）的游標分頁專案詞彙。
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擷取特定測試執行的詳細資料。
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 擷取特定測試規格檔案執行的除錯資料。
currents-get-spec-files-performance擷取專案在指定日期範圍內的規格檔案效能指標。
currents-get-tests-performance擷取專案在指定日期範圍內的彙總測試指標。
currents-get-tests-signatures根據專案、規格檔案路徑和測試標題產生唯一的測試簽章。
currents-get-test-results擷取特定測試簽章的歷史測試執行結果。
currents-get-context取得執行、實例或測試層級的測試失敗內容，供 AI 除錯使用。
currents-get-errors-explorer取得專案在指定日期範圍內的彙總錯誤指標。
currents-get-test-evidence收集 CI 執行中測試產生的證據工件（螢幕截圖、影片、追蹤、附件），並提供依測試分組的簽署下載 URL。
currents-list-webhooks列出專案的所有 Webhook。
currents-create-webhook為專案建立新的 Webhook。
currents-get-webhook依 ID 取得單一 Webhook。
currents-update-webhook更新現有的 Webhook。
currents-delete-webhook刪除 Webhook。

技能

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

技能描述
collect-evidence使用 CI 測試工件（前後螢幕截圖、文字附件、影片、追蹤）展示已實作的功能有效，或進行示範。

伺服器會將每個技能發布為 MCP 資源，因此已連線的代理程式可以 在沒有本機副本的情況下列出並讀取它們：

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

僅從磁碟載入技能的代理程式仍需要副本——請將技能 目錄放在代理程式的技能位置（例如 Claude Code 的 .claude/skills/）。

設定

API 金鑰

依照此處的說明取得 Currents API 金鑰。

與 Cursor 搭配使用

  1. 前往 Cursor 設定 > MCP > 啟用
  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"
      }
    }
  }
}

遠端（託管）MCP 端點

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

託管伺服器本身不執行任何驗證。每個請求必須攜帶 您的 Currents API 金鑰作為 Bearer 權杖，該權杖會傳遞到 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 代理程式或服務，並確保它們安全地處理您的資料。

參考資料