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

工具

ToolDescription
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 中使用

  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 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 代理或服务,并确保它们安全地处理你的数据。

参考资料