Currents MCP Server
官方使AI代理能够修复上报到Currents的Playwright测试失败。
文档
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-list-webhooks | 列出项目的所有 Webhook。 |
currents-create-webhook | 为项目创建新 Webhook。 |
currents-get-webhook | 通过 ID 获取单个 Webhook。 |
currents-update-webhook | 更新现有 Webhook。 |
currents-delete-webhook | 删除 Webhook。 |
设置
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"
}
}
}
}
⚠️ 注意
通过将 AI 工具(例如通过 MCP)连接到 Currents,您即授予它们访问您的 API 密钥、测试结果和 CI 元数据的权限。您有责任审查您使用的任何 AI 代理或服务,并确保它们安全地处理您的数据。