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 和项目设置
- 让代理根据实际测试输出修复问题,而不是靠猜测
工具
| Tool | Description |
|---|---|
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 文件(实例)或单个测试中失败测试的错误、步骤和文件——内容与 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 摘要、胶片条和无障碍快照可在评论中查看,另附截图、附件和视频。 |
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 Key
按照此处的说明获取 Currents API key。
在 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 key。
要安装插件(它会添加技能和服务器):
-
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 网页版/移动应用等远程
连接器使用。
托管服务器不进行任何自身身份验证。每个请求都必须携带你的 Currents API key 作为 Bearer token,并将其传递给 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 key、测试结果和 CI 元数据的权限。你有责任审查所使用的 AI 代理或服务,并确保它们安全地处理你的数据。