Currents

官方

使AI代理能够修复上报到Currents的Playwright测试失败。

GitHub

试用此 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 服务器

让您的 AI 编码代理全面了解 CI 测试结果。Currents MCP 服务器将 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-affected-executions`	列出在指定日期范围内应用了特定操作/规则的测试执行。
`currents-get-projects`	检索 Currents 平台中可用的项目。
`currents-get-project`	按 ID 获取单个项目。
`currents-get-project-insights`	获取指定日期范围内项目的聚合运行和测试指标。
`currents-list-pull-requests`	列出项目的拉取请求卡片（按 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 一起使用

前往 Cursor 设置 > MCP > 启用
将以下内容添加到您的 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 Web/移动应用等远程连接器。

托管服务器本身不进行任何身份验证。每个请求必须携带您的 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 代理或服务，并确保它们安全地处理您的数据。