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?

Jalankan kueri dan hasil tes — Minta hasil CI terbaru atau hasil historis melalui currents-get-runs dan currents-get-test-results.
Diagnosis kegagalan dengan konteks — Dapatkan konteks kegagalan untuk debugging AI di tingkat run, instance, atau tes menggunakan currents-get-context.
Kumpulkan bukti tes — Ambil tangkapan layar, video, jejak, dan lampiran dari run CI dengan currents-get-test-evidence.
Kelola karantina dan tindakan — Daftar, buat, perbarui, atau nonaktifkan tindakan seperti aturan karantina melalui currents-list-actions dan currents-create-action.
Kelola webhook — Daftar, buat, perbarui, atau hapus webhook proyek dengan currents-list-webhooks dan currents-create-webhook.

Dokumentasi

Currents MCP Server

Berikan agen pengkodean AI 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

Alat	Deskripsi
`currents-list-actions`	Mencantumkan semua aksi untuk sebuah proyek dengan pemfilteran opsional.
`currents-create-action`	Membuat aksi baru untuk sebuah proyek.
`currents-get-action`	Mendapatkan satu aksi berdasarkan ID.
`currents-update-action`	Memperbarui aksi yang 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`	Mencantumkan tes yang terpengaruh oleh aksi (karantina, lewati, tag) untuk sebuah proyek dalam rentang tanggal.
`currents-get-affected-test-executions`	Mendapatkan detail eksekusi untuk tes terpengaruh tertentu (berdasarkan tanda tangan) dalam rentang tanggal.
`currents-get-affected-executions`	Mencantumkan eksekusi tes di mana aksi/aturan tertentu diterapkan, 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`	Mencantumkan kartu pull-request untuk sebuah proyek (run dikelompokkan berdasarkan meta.pr.id).
`currents-list-project-terms`	Mencantumkan istilah proyek dengan paginasi kursor untuk satu jenis (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 ada ke tes run menggunakan integrasi Jira organisasi.
`currents-list-jira-projects`	Mencantumkan proyek Jira yang tersedia untuk integrasi organisasi.
`currents-list-jira-issue-types`	Mencantumkan jenis isu Jira dan bidang kustom untuk proyek Jira.
`currents-get-runs`	Mengambil daftar run untuk proyek tertentu dengan pemfilteran 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`	Mendapatkan konteks kegagalan tes untuk debugging AI di tingkat run, instance, atau tes.
`currents-get-errors-explorer`	Mendapatkan metrik kesalahan yang digabungkan untuk sebuah proyek dalam rentang tanggal.
`currents-get-test-evidence`	Mengumpulkan artefak bukti (screenshot, video, jejak, lampiran) yang dihasilkan oleh tes dalam run CI, dengan URL unduhan yang ditandatangani dikelompokkan per tes.
`currents-list-webhooks`	Mencantumkan semua webhook untuk sebuah proyek.
`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
`collect-evidence`	Menunjukkan bahwa pekerjaan yang diimplementasikan berfungsi, atau mendemonstrasikannya, menggunakan artefak tes CI — screenshot sebelum/sesudah, lampiran teks, video, jejak.

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

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

Agen yang memuat keterampilan hanya 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 instruksi 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 Currents MCP ke Claude Code

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

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

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

Endpoint MCP jarak jauh (hosted)

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

Server yang di-host 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 menggunakan HTTP biasa; TLS dan domain publik berakhir di proxy terbalik / penyeimbang beban di depan kontainer. Endpoint GET /healthz disediakan untuk pemeriksaan kelangsungan hidup.

⚠️ Perhatian

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