Currents

Máy chủ MCP Currents

Cung cấp cho các tác nhân mã AI của bạn khả năng hiển thị đầy đủ về kết quả kiểm thử CI. Máy chủ MCP Currents kết nối các công cụ như Cursor và Claude trực tiếp với bảng điều khiển Currents của bạn, để các tác nhân có thể chẩn đoán các bài kiểm thử không ổn định, xác định chính xác lỗi và hành động dựa trên dữ liệu thực thi thực tế -- mà không cần rời khỏi trình soạn thảo của bạn.

• Truy vấn các lần chạy, tệp spec và kết quả kiểm thử riêng lẻ từ CI
• Hiển thị xu hướng lỗi và chỉ số hiệu suất trên toàn bộ bộ kiểm thử của bạn
• Quản lý quy tắc cách ly, webhook và cài đặt dự án theo chương trình
• Để các tác nhân sửa những gì bị hỏng bằng đầu ra kiểm thử thực tế, không phải phỏng đoán

Công cụ

Công cụ	Mô tả
currents-list-actions	Liệt kê tất cả các action cho một dự án với bộ lọc tùy chọn.
currents-create-action	Tạo một action mới cho một dự án.
currents-get-action	Lấy một action cụ thể theo ID.
currents-update-action	Cập nhật một action hiện có.
currents-delete-action	Xóa (lưu trữ) một action.
currents-enable-action	Kích hoạt một action đã bị vô hiệu hóa.
currents-disable-action	Vô hiệu hóa một action đang hoạt động.
currents-list-affected-tests	Liệt kê các bài kiểm thử bị ảnh hưởng bởi các action (cách ly, bỏ qua, gắn thẻ) cho một dự án trong một khoảng thời gian.
currents-get-affected-test-executions	Khóa theo một bài kiểm thử: liệt kê các lần thực thi của một bài kiểm thử mà một action đã áp dụng, trong một khoảng thời gian, kèm theo run, nhánh và commit của từng lần.
currents-get-action-executions	Khóa theo một action: liệt kê các lần thực thi bài kiểm thử mà một quy tắc đã áp dụng, trên mọi bài kiểm thử mà nó tác động, trong một khoảng thời gian.
currents-get-projects	Truy xuất các dự án có sẵn trên nền tảng Currents.
currents-get-project	Lấy một dự án cụ thể theo ID.
currents-get-project-insights	Lấy số liệu tổng hợp về run và bài kiểm thử cho một dự án trong một khoảng thời gian.
currents-list-pull-requests	Liệt kê các thẻ pull-request cho một dự án (các run được nhóm theo meta.pr.id).
currents-list-project-terms	Liệt kê các thuật ngữ dự án được phân trang bằng con trỏ cho một loại (tag, branch, authorName, v.v.).
currents-create-jira-issue	Tạo một issue Jira từ một bài kiểm thử trong run bằng tích hợp Jira của tổ chức.
currents-link-jira-issue	Liên kết một issue Jira hiện có với một bài kiểm thử trong run bằng tích hợp Jira của tổ chức.
currents-list-jira-projects	Liệt kê các dự án Jira có sẵn cho tích hợp của tổ chức.
currents-list-jira-issue-types	Liệt kê các loại issue Jira và trường tùy chỉnh cho một dự án Jira.
currents-get-runs	Truy xuất danh sách các run cho một dự án cụ thể với bộ lọc tùy chọn.
currents-get-run-details	Truy xuất chi tiết của một run kiểm thử cụ thể.
currents-find-run	Tìm một run theo các tham số truy vấn.
currents-cancel-run	Hủy một run đang tiến hành.
currents-reset-run	Đặt lại các tệp spec bị lỗi trong một run để cho phép thực thi lại.
currents-delete-run	Xóa một run và tất cả dữ liệu liên quan.
currents-cancel-run-github-ci	Hủy một run theo ID workflow run của GitHub Actions và số lần thử.
currents-get-spec-instance	Truy xuất dữ liệu gỡ lỗi từ một lần thực thi cụ thể của một tệp spec kiểm thử theo instanceId.
currents-get-spec-files-performance	Truy xuất số liệu hiệu suất của các tệp spec cho một dự án cụ thể trong một khoảng thời gian.
currents-get-tests-performance	Truy xuất số liệu tổng hợp về bài kiểm thử cho một dự án cụ thể trong một khoảng thời gian.
currents-get-tests-signatures	Tạo một chữ ký kiểm thử duy nhất dựa trên dự án, đường dẫn tệp spec và tiêu đề bài kiểm thử.
currents-get-test-results	Truy xuất kết quả thực thi kiểm thử lịch sử cho một chữ ký kiểm thử cụ thể.
currents-get-context	Dùng để sửa các bài kiểm thử thất bại trong CI: trả về lỗi, các bước và tệp tin của các bài kiểm thử thất bại trong một lần chạy, một tệp spec (instance) hoặc một bài kiểm thử — cùng nội dung với mục Fix trong bảng điều khiển Currents.
currents-get-errors-explorer	Lấy số liệu lỗi tổng hợp cho một dự án trong một phạm vi ngày.
currents-get-test-evidence	Thu thập các tạo phẩm bằng chứng (ảnh chụp màn hình, video, trace, tệp đính kèm) do các bài kiểm thử tạo ra trong một lần chạy CI, với các URL tải xuống đã ký được nhóm theo từng bài kiểm thử.
currents-create-evidence-links	Tạo một liên kết có thể chia sẻ đến bằng chứng của một lần thử kiểm thử, được phục vụ từ Playwright trace của nó, và các URL trên đó: một bản tóm tắt markdown về những gì lần thử đã làm và những gì thất bại, một dải phim, một bản ghi màn hình động, ảnh chụp DOM, yêu cầu mạng và tệp đính kèm.
currents-create-session	Ghi lại một phiên trình duyệt bạn đã điều khiển như một lần chạy Currents, để bằng chứng của nó có thể được đọc và chia sẻ như của một lần chạy CI.
currents-list-webhooks	Liệt kê tất cả webhook cho một dự án.
currents-create-share-link	Tạo một liên kết công khai đến kết quả kiểm thử mà bất kỳ ai cũng có thể mở mà không cần đăng nhập, cho đến khi nó hết hạn. mục đích "fix" là ngữ cảnh thất bại, dành cho một tác nhân sẽ sửa các bài kiểm thử — cùng nội dung với currents-get-context, bao gồm các bài kiểm thử flaky và được đánh dấu là flaky. mục đích "report" liệt kê mọi bài kiểm thử với các lần thử và tệp tin của nó, dành cho một người.
currents-create-webhook	Tạo một webhook mới cho một dự án.
currents-get-webhook	Lấy một webhook duy nhất theo ID.
currents-update-webhook	Cập nhật một webhook hiện có.
currents-delete-webhook	Xóa một webhook.

Kỹ năng

Các kỹ năng của tác nhân giúp dạy tác nhân AI các quy trình làm việc Currents nhiều bước.

Kỹ năng	Mô tả
browser-evidence	Thử nghiệm.
collect-evidence	Chứng minh rằng công việc bạn triển khai thực sự hoạt động, hoặc trình diễn nó, từ các bài kiểm tra chạy trong CI qua Currents — một liên kết dấu vết có digest, filmstrip và ảnh chụp khả năng truy cập được đọc trong một bình luận, cùng với ảnh chụp màn hình, tệp đính kèm và video.
fix-failing-tests	Sửa các bài kiểm tra thất bại trong CI, sử dụng kết quả mà Currents ghi lại — lỗi, các bước, dấu vết, ảnh chụp màn hình và đầu ra console.

Máy chủ xuất bản mỗi kỹ năng dưới dạng một tài nguyên MCP, vì vậy một tác nhân được kết nối có thể liệt kê và đọc chúng mà không cần bản sao cục bộ:

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

Các tác nhân chỉ tải kỹ năng từ đĩa vẫn cần một bản sao — đặt thư mục kỹ năng vào vị trí kỹ năng của tác nhân (ví dụ: .claude/skills/ cho Claude Code).

Thiết lập

Khóa API

Lấy khóa API Currents bằng cách làm theo hướng dẫn tại đây.

Sử dụng với Cursor

1. Đi tới Cursor Settings > MCP > Enable
2. Thêm nội dung sau vào mcp.json của bạn.

{
  "mcpServers": {
    "currents": {
      "command": "npx",
      "args": ["-y", "@currents/mcp"],
      "env": {
        "CURRENTS_API_KEY": "your-api-key"
      }
    }
  }
}

Claude

Chạy lệnh này để thêm Currents MCP vào Claude Code

claude mcp add --transport stdio currents --env CURRENTS_API_KEY=<KEY> -- npx -y @currents/mcp

Thêm nội dung sau để bật Currents MCP trên Claude Desktop (sửa tệp claude_desktop_config.json):

{
  "mcpServers": {
    "currents": {
      "command": "npx",
      "args": ["-y", "@currents/mcp"],
      "env": {
        "CURRENTS_API_KEY": "your-api-key"
      }
    }
  }
}

Điểm cuối MCP từ xa (được lưu trữ)

Ngoài giao thức vận chuyển stdio cục bộ ở trên, cùng một máy chủ có thể chạy dưới dạng một điểm cuối Streamable HTTP được lưu trữ (ví dụ: https://mcp.currents.dev/mcp) để sử dụng với các bộ kết nối từ xa như ứng dụng web/di động Claude.

Máy chủ được lưu trữ không thực hiện xác thực riêng của nó. Mỗi yêu cầu phải mang khóa API Currents của bạn dưới dạng mã thông báo Bearer, được chuyển tiếp tới API Currents:

Authorization: Bearer <your-currents-api-key>

Ví dụ cấu hình máy khách (bộ kết nối từ xa):

{
  "mcpServers": {
    "currents": {
      "url": "https://mcp.currents.dev/mcp",
      "headers": {
        "Authorization": "Bearer your-api-key"
      }
    }
  }
}

Tự chạy máy chủ 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

Máy chủ Node nói HTTP thuần túy; TLS và tên miền công khai kết thúc tại proxy ngược / bộ cân bằng tải phía trước container. Một điểm cuối GET /healthz được cung cấp để kiểm tra trạng thái hoạt động.

⚠️ Lưu ý

Bằng cách kết nối các công cụ AI (ví dụ: qua MCP) với Currents, bạn đang cấp cho chúng quyền truy cập vào khóa API, kết quả kiểm tra và siêu dữ liệu CI của bạn. Bạn có trách nhiệm kiểm tra bất kỳ tác nhân hoặc dịch vụ AI nào bạn sử dụng và đảm bảo chúng xử lý dữ liệu của bạn một cách an toàn.

Tham khảo

• Currents
• Tài liệu Currents
• Hướng dẫn đóng góp
• Phát hành và xuất bản
• Giấy phép