Currents MCP Server

Currents MCP Server

让 AI 编码 Agent 全面了解 CI 测试结果。Currents MCP Server 将 Cursor 和 Claude 等工具直接连接到你的 Currents 仪表板，让 Agent 无需离开编辑器即可诊断不稳定的测试、定位失败原因，并依据真实执行数据采取行动。

• 查询 CI 中的运行记录、spec 文件和单项测试结果
• 展示测试套件中的错误趋势和性能指标
• 以编程方式管理隔离规则、webhook 和项目设置
• 让 Agent 根据实际测试输出修复问题，而非凭空猜测

工具

工具	描述
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 项目的 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 获取某个规格文件执行的原始结果：每项测试的状态和尝试记录，以及制品 URL。
currents-get-spec-files-performance	获取特定项目在指定日期范围内的规格文件性能指标。
currents-get-tests-performance	获取特定项目在指定日期范围内的测试汇总指标。
currents-get-tests-signatures	根据项目、规格文件路径和测试标题生成唯一的测试签名。
currents-get-test-results	获取特定测试签名的历史测试执行结果。
currents-get-context	修复测试或查明测试在 CI 中失败的原因时，请先调用此工具：它会返回某次运行、某个规格文件（实例）或某项测试中失败测试的错误、步骤和文件，内容与 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）：可为规格文件、测试或运行本身添加日志。
currents-list-webhooks	列出项目的所有 Webhook。
currents-create-share-link	创建公开的测试结果链接，任何人都可以打开，无需登录，直到链接过期。purpose "fix" 表示失败上下文，供修复测试的 Agent 使用，内容与 currents-get-context 相同，并包含标记为不稳定的测试；purpose "report" 则面向用户，列出每项测试及其尝试记录和文件；对于会话，它会打开会话页面，显示状态、错误、附件和追踪记录。
currents-create-webhook	为项目创建新的 Webhook。
currents-get-webhook	按 ID 获取单个 Webhook。
currents-update-webhook	更新现有 Webhook。
currents-delete-webhook	删除 Webhook。

技能

教授 AI Agent 多步骤 Currents 工作流的 Agent 技能。

技能	描述
browser-evidence	实验性：当没有可运行的测试时，在你亲自操作的浏览器中证明更改有效。
collect-evidence	通过 Currents 展示你实现的工作确实有效，或进行演示：从 CI 中运行的测试获取结果——在评论中读取摘要、影片胶片和无障碍快照的追踪 API 链接，以及屏幕截图、附件和视频。
fix-failing-tests	使用 Currents 记录的结果修复 CI 中失败的测试，包括错误、步骤、追踪记录、屏幕截图和控制台输出。

服务会将每项技能作为 MCP 资源发布，因此已连接的 Agent 无需本地副本即可 列出并读取这些技能：

skill://currents/collect-evidence/SKILL.md
skill://currents/collect-evidence/references/instrumentation.md

仅从磁盘加载技能的 Agent 仍需要一份副本——将技能 目录放入 Agent 的技能位置（例如，Claude Code 的 .claude/skills/）。

设置

API 密钥

按照此处的说明获取 Currents API 密钥。

在 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 密钥。

要安装插件（它会添加技能和服务）：

• 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 密钥作为 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 Agent 或服务，并确保它们安全地处理你的数据。

References

• Currents
• Currents Documentation
• Contribution Guide
• Releasing and Publishing
• License