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 quan sát đầy đủ 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ả hành động cho một dự án với bộ lọc tùy chọn.
currents-create-action	Tạo một hành động mới cho một dự án.
currents-get-action	Lấy một hành động theo ID.
currents-update-action	Cập nhật một hành động hiện có.
currents-delete-action	Xóa (lưu trữ) một hành động.
currents-enable-action	Kích hoạt một hành động đã bị vô hiệu hóa.
currents-disable-action	Vô hiệu hóa một hành động đ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 hành động (cách ly, bỏ qua, gắn thẻ) cho một dự án trong một phạm vi ngày.
currents-get-affected-test-executions	Lấy chi tiết thực thi cho một bài kiểm thử bị ảnh hưởng cụ thể (theo chữ ký) trong một phạm vi ngày.
currents-get-affected-executions	Liệt kê các lần thực thi kiểm thử nơi một hành động/quy tắc cụ thể được áp dụng, trong một phạm vi ngày.
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 theo ID.
currents-get-project-insights	Lấy số liệu tổng hợp về lần chạy và kiểm thử cho một dự án trong một phạm vi ngày.
currents-list-pull-requests	Liệt kê các thẻ yêu cầu kéo cho một dự án (các lần chạy đượ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 vấn đề Jira từ một bài kiểm thử chạy bằng tích hợp Jira của tổ chức.
currents-link-jira-issue	Liên kết một vấn đề Jira hiện có với một bài kiểm thử chạy 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 tổ chức.
currents-list-jira-issue-types	Liệt kê các loại vấn đề 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 lần chạy 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 lần chạy kiểm thử cụ thể.
currents-find-run	Tìm một lần chạy theo tham số truy vấn.
currents-cancel-run	Hủy một lần chạy đang tiến hành.
currents-reset-run	Đặt lại các tệp spec bị lỗi trong một lần chạy để cho phép thực thi lại.
currents-delete-run	Xóa một lần chạy và tất cả dữ liệu liên quan.
currents-cancel-run-github-ci	Hủy một lần chạy theo ID lần chạy 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 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 phạm vi ngày.
currents-get-tests-performance	Truy xuất số liệu kiểm thử tổng hợp cho một dự án cụ thể trong một phạm vi ngày.
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 đề 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	Lấy ngữ cảnh lỗi kiểm thử để gỡ lỗi AI ở cấp lần chạy, phiên bản hoặc kiểm thử.
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, dấu vết, 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 URL tải xuống đã ký được nhóm theo từng bài kiểm thử.
currents-list-webhooks	Liệt kê tất cả webhook cho một dự án.
currents-create-webhook	Tạo một webhook mới cho một dự án.
currents-get-webhook	Lấy một webhook 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 dạy các tác nhân AI quy trình làm việc Currents nhiều bước.

Kỹ năng	Mô tả
collect-evidence	Chứng minh rằng công việc đã triển khai hoạt động, hoặc trình diễn nó, bằng các tạo phẩm kiểm thử CI — ảnh chụp màn hình trước/sau, tệp đính kèm văn bản, video, dấu vết.

Máy chủ xuất bản mọi kỹ năng dưới dạng tài nguyên MCP, để 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 để kích hoạt Currents MCP trên Claude Desktop (chỉnh 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 điểm cuối HTTP Streamable đượ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 đến 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 vùng chứa. 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 thử và siêu dữ liệu CI của bạn. Bạn có trách nhiệm kiểm tra kỹ lưỡng 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