Currents

resmi

Memungkinkan Agen AI untuk memperbaiki kegagalan tes Playwright yang dilaporkan ke Currents.

GitHub

Coba MCP iniDisponsori

Apa yang bisa Anda lakukan dengan Currents MCP?

Diagnose failing tests — Minta error, langkah, dan file di balik kegagalan CI run melalui currents-get-context untuk memperbaiki masalah secara langsung.
Review test performance — Dapatkan metrik agregat run dan test untuk sebuah proyek dalam rentang tanggal menggunakan currents-get-project-insights.
Manage quarantine rules — Daftar, buat, perbarui, aktifkan, atau nonaktifkan aksi yang memengaruhi test, seperti mengarantina spec yang flaky.
Collect test evidence — Tarik screenshot, video, trace, dan lampiran dari CI run dengan currents-get-test-evidence untuk debugging atau demo.
Share results externally — Buat tautan publik yang kedaluwarsa ke hasil test agar siapa pun dapat melihatnya tanpa masuk menggunakan currents-create-share-link.
Integrate with Jira — Buat atau tautkan isu Jira langsung dari test run yang gagal menggunakan integrasi Jira organisasi Anda.

Dokumentasi

Server MCP Currents

Berikan agen AI coding Anda visibilitas penuh terhadap hasil tes CI Anda. Server MCP Currents menghubungkan alat seperti Cursor dan Claude langsung ke dasbor Currents Anda, sehingga agen dapat mendiagnosis tes yang flaky, menemukan kegagalan, dan bertindak berdasarkan data eksekusi nyata — tanpa meninggalkan editor Anda.

Kueri run, file spec, dan hasil tes individual dari CI
Tampilkan tren kesalahan dan metrik kinerja di seluruh rangkaian tes Anda
Kelola aturan karantina, webhook, dan pengaturan proyek secara terprogram
Biarkan agen memperbaiki apa yang rusak menggunakan output tes aktual, bukan tebakan

Alat

Tool	Deskripsi
`currents-list-actions`	Menampilkan semua aksi untuk sebuah proyek dengan filter opsional.
`currents-create-action`	Membuat aksi baru untuk sebuah proyek.
`currents-get-action`	Mendapatkan satu aksi berdasarkan ID.
`currents-update-action`	Memperbarui aksi yang sudah ada.
`currents-delete-action`	Menghapus (mengarsipkan) sebuah aksi.
`currents-enable-action`	Mengaktifkan aksi yang dinonaktifkan.
`currents-disable-action`	Menonaktifkan aksi yang aktif.
`currents-list-affected-tests`	Menampilkan tes yang terpengaruh oleh aksi (karantina, lewati, tag) untuk sebuah proyek dalam rentang tanggal.
`currents-get-affected-test-executions`	Berdasarkan tes: menampilkan eksekusi dari satu tes yang diterapkan oleh sebuah aksi, dalam rentang tanggal, beserta run, branch, dan commit dari masing-masing.
`currents-get-action-executions`	Berdasarkan aksi: menampilkan eksekusi tes yang diterapkan oleh satu aturan, di semua tes yang disentuhnya, dalam rentang tanggal.
`currents-get-projects`	Mengambil proyek yang tersedia di platform Currents.
`currents-get-project`	Mendapatkan satu proyek berdasarkan ID.
`currents-get-project-insights`	Mendapatkan metrik run dan tes yang digabungkan untuk sebuah proyek dalam rentang tanggal.
`currents-list-pull-requests`	Menampilkan kartu pull-request untuk sebuah proyek (run yang dikelompokkan berdasarkan meta.pr.id).
`currents-list-project-terms`	Menampilkan istilah proyek dengan paginasi kursor untuk satu tipe (tag, branch, authorName, dll.).
`currents-create-jira-issue`	Membuat isu Jira dari tes run menggunakan integrasi Jira organisasi.
`currents-link-jira-issue`	Menautkan isu Jira yang sudah ada ke tes run menggunakan integrasi Jira organisasi.
`currents-list-jira-projects`	Menampilkan proyek Jira yang tersedia untuk integrasi organisasi.
`currents-list-jira-issue-types`	Menampilkan tipe isu Jira dan bidang kustom untuk sebuah proyek Jira.
`currents-get-runs`	Mengambil daftar run untuk proyek tertentu dengan filter opsional.
`currents-get-run-details`	Mengambil detail dari run tes tertentu.
`currents-find-run`	Menemukan run berdasarkan parameter kueri.
`currents-cancel-run`	Membatalkan run yang sedang berlangsung.
`currents-reset-run`	Mengatur ulang file spec yang gagal dalam sebuah run untuk memungkinkan eksekusi ulang.
`currents-delete-run`	Menghapus run dan semua data terkait.
`currents-cancel-run-github-ci`	Membatalkan run berdasarkan ID run workflow GitHub Actions dan nomor percobaan.
`currents-get-spec-instance`	Mengambil data debugging dari eksekusi tertentu dari file spec tes berdasarkan instanceId.
`currents-get-spec-files-performance`	Mengambil metrik kinerja file spec untuk proyek tertentu dalam rentang tanggal.
`currents-get-tests-performance`	Mengambil metrik tes yang digabungkan untuk proyek tertentu dalam rentang tanggal.
`currents-get-tests-signatures`	Menghasilkan tanda tangan tes unik berdasarkan proyek, jalur file spec, dan judul tes.
`currents-get-test-results`	Mengambil hasil eksekusi tes historis untuk tanda tangan tes tertentu.
`currents-get-context`	Gunakan untuk memperbaiki tes yang gagal di CI: mengembalikan error, langkah-langkah, dan file dari tes yang gagal pada sebuah run, file spesifikasi (instance), atau satu tes — konten yang sama dengan Fix di dasbor Currents.
`currents-get-errors-explorer`	Mendapatkan metrik error yang digabungkan untuk sebuah proyek dalam rentang tanggal.
`currents-get-test-evidence`	Mengumpulkan artefak bukti (screenshot, video, trace, lampiran) yang dihasilkan oleh tes dalam sebuah run CI, dengan URL unduhan yang ditandatangani yang dikelompokkan per tes.
`currents-create-evidence-links`	Membuat tautan yang dapat dibagikan ke bukti percobaan tes, disajikan dari trace Playwright-nya, dan URL di dalamnya: ringkasan markdown tentang apa yang dilakukan percobaan dan apa yang gagal, strip film, screencast animasi, snapshot DOM, permintaan jaringan, dan lampiran.
`currents-create-session`	Merekam sesi browser yang Anda kendarai sebagai run Currents, sehingga buktinya dapat dibaca dan dibagikan seperti run CI.
`currents-list-webhooks`	Mencantumkan semua webhook untuk sebuah proyek.
`currents-create-share-link`	Membuat tautan publik ke hasil tes yang dapat dibuka siapa pun tanpa masuk, hingga kedaluwarsa. tujuan "fix" adalah konteks kegagalan, untuk agen yang akan memperbaiki tes — konten yang sama dengan currents-get-context, dengan tes flaky disertakan dan ditandai flaky. tujuan "report" mencantumkan setiap tes dengan percobaan dan file-nya, untuk seseorang.
`currents-create-webhook`	Membuat webhook baru untuk sebuah proyek.
`currents-get-webhook`	Mendapatkan satu webhook berdasarkan ID.
`currents-update-webhook`	Memperbarui webhook yang ada.
`currents-delete-webhook`	Menghapus webhook.

Keterampilan

Keterampilan agen yang mengajarkan agen AI alur kerja Currents multi-langkah.

Keterampilan	Deskripsi
`browser-evidence`	Eksperimental.
`collect-evidence`	Tunjukkan bahwa pekerjaan yang Anda implementasikan benar-benar berfungsi, atau demo, dari tes yang dijalankan di CI melalui Currents — tautan jejak yang ringkasan, cuplikan film, dan snapshot aksesibilitasnya terbaca di dalam komentar, plus tangkapan layar, lampiran, dan video.
`fix-failing-tests`	Perbaiki tes yang gagal di CI, menggunakan hasil yang direkam Currents — kesalahan, langkah, jejak, tangkapan layar, dan keluaran konsol.

Server memublikasikan setiap keterampilan sebagai sumber daya MCP, sehingga agen yang terhubung dapat mendaftar dan membacanya tanpa salinan lokal:

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

Agen yang hanya memuat keterampilan dari disk masih memerlukan salinan — letakkan direktori keterampilan di lokasi keterampilan agen (misalnya .claude/skills/ untuk Claude Code).

Pengaturan

Kunci API

Dapatkan kunci API Currents dengan mengikuti petunjuk di sini.

Penggunaan dengan Cursor

Buka Pengaturan Cursor > MCP > Aktifkan
Tambahkan berikut ini ke mcp.json Anda.

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

Claude

Jalankan perintah ini untuk menambahkan MCP Currents ke Claude Code

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

Tambahkan berikut ini untuk mengaktifkan MCP Currents di Claude Desktop (edit file claude_desktop_config.json):

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

Titik akhir MCP jarak jauh (hosted)

Selain transport stdio lokal di atas, server yang sama dapat dijalankan sebagai titik akhir Streamable HTTP yang dihosting (misalnya https://mcp.currents.dev/mcp) untuk digunakan dengan konektor jarak jauh seperti aplikasi web/seluler Claude.

Server yang dihosting tidak melakukan autentikasi sendiri. Setiap permintaan harus membawa kunci API Currents Anda sebagai token Bearer, yang diteruskan ke API Currents:

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

Contoh konfigurasi klien (konektor jarak jauh):

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

Menjalankan server HTTP sendiri:

# 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

Server Node berbicara HTTP biasa; TLS dan domain publik berakhir di proksi balik / penyeimbang beban di depan kontainer. Titik akhir GET /healthz disediakan untuk pemeriksaan liveness.

⚠️ Pemberitahuan

Dengan menghubungkan alat AI (misalnya, melalui MCP) ke Currents, Anda memberi mereka akses ke kunci API, hasil tes, dan metadata CI Anda. Merupakan tanggung jawab Anda untuk memeriksa agen atau layanan AI apa pun yang Anda gunakan, dan memastikan mereka menangani data Anda dengan aman.