Currents
官方讓 AI 代理修復回報給 Currents 的 Playwright 測試失敗。
你可以用 Currents MCP 做什麼?
- 診斷 CI 失敗 — 使用
currents-get-context擷取執行作業、規格檔案或單一測試中失敗測試背後的錯誤、步驟和檔案。 - 檢視執行作業與結果 — 列出並篩選專案執行作業,然後擷取執行作業詳細資料、規格執行個體結果,以及依簽章查詢的歷史測試結果。
- 找出不穩定與緩慢的測試 — 查詢測試和規格檔案的效能指標,以及指定日期範圍內彙總的錯誤趨勢。
- 管理隔離動作 — 建立、啟用、停用或刪除動作,並列出受其影響的測試和執行作業。
- 收集測試證據 — 從 CI 執行作業收集螢幕截圖、影片、追蹤記錄和附件,或建立可分享的追蹤連結。
- 管理 Webhook 和 Jira — 列出、建立、更新或刪除專案 Webhook,並從執行作業中的測試建立或連結 Jira 議題。
文件
Currents MCP Server
讓您的 AI 程式碼代理全面掌握 CI 測試結果。Currents MCP Server 可將 Cursor 和 Claude 等工具直接連接至您的 Currents 儀表板,讓代理無須離開編輯器,就能診斷不穩定的測試、找出失敗原因,並根據實際執行資料採取行動。
- 查詢 CI 中的執行記錄、規格檔案和個別測試結果
- 掌握整個測試套件的錯誤趨勢和效能指標
- 以程式方式管理隔離規則、webhook 和專案設定
- 讓代理根據實際測試輸出而非猜測,修復問題
工具
| 工具 | 說明 |
|---|---|
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 使用
- 前往 Cursor Settings > MCP > Enable
- 將以下內容新增至你的
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 代理或服務,並確保它們安全地處理你的資料。