Permet aux agents de codage IA d'interroger les exécutions de tests CI, les fichiers de spécification et les résultats de tests depuis le tableau de bord Currents afin de diagnostiquer les échecs et les tests instables.
Aussi connu sous currents-dev/currents-mcp, currents-mcp, @currents/mcp
- Étoiles
- 21
- Outils
- 43
- Téléchargements, 30 jours
- 321 912
- Dernière version
- 1.0.0
- Dernier commit
- 13 nov. 2026
- Licence
- Apache-2.0
Qu'est-ce que Currents MCP ?
Currents est un serveur MCP. Permet aux agents de codage IA d'interroger les exécutions de tests CI, les fichiers de spécification et les résultats de tests depuis le tableau de bord Currents afin de diagnostiquer les échecs et les tests instables. Il expose 43 outils, comme currents-list-actions, currents-create-action, currents-get-action.
Résumé généré à partir du README du projet
À propos du MCP server Currents
Currents permet aux développeurs utilisant des agents IA de diagnostiquer les échecs de CI et les tests instables directement depuis leur environnement de codage. En connectant des outils comme Claude ou Cursor à votre tableau de bord Currents, votre agent gagne en visibilité sur les données d'exécution réelles, ce qui lui permet d'aller au-delà des suppositions lors de la correction de code défectueux. Cette connexion nécessite une CURRENTS_API_KEY pour fonctionner.
Les développeurs utilisent ce serveur pour interroger des exécutions spécifiques, des fichiers de spécification et des résultats de tests individuels. Les outils disponibles permettent à un agent de gérer les paramètres du projet, de traiter les règles de quarantaine et de surveiller les tendances d'erreurs ou les métriques de performance. Il peut également interagir avec Jira pour créer ou lier des tickets à des exécutions de tests spécifiques. Grâce à des commandes comme currents-get-run-details et currents-get-project-insights, un agent peut récupérer le statut, les informations de commit et les métriques agrégées pour comprendre la santé d'une suite de tests.
Ce que vous pouvez faire avec
- 1Diagnostiquer les échecs de tests instablesDemandez à votre agent IA d'enquêter sur la raison pour laquelle un test spécifique échoue en examinant son historique d'exécution récent.
- 2Analyser les métriques de performance du projetDemandez un résumé des tendances d'erreurs et des métriques de performance pour un projet spécifique sur une période donnée.
- 3Gérer les règles de quarantaine des testsDonnez instruction à un agent pour mettre à jour ou gérer par programmation les règles de quarantaine et autres paramètres du projet.
- 4Intégrer les échecs de tests avec JiraLaissez un agent IA créer automatiquement un nouveau ticket Jira lorsqu'il identifie une exécution de test en échec.
Extrait du README du projet. Chaque cas d'utilisation est vérifié par rapport à une citation du document.
Comment installer Currents MCP
Formats vérifiés le 10 nov. 2026Ajouter à CursorAjouter à GooseInstaller Currents MCP dans Claude Code
$ claude mcp add currents-mcp -- npx -y @currents/mcpInstaller Currents MCP dans Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"currents-mcp": {
"command": "npx",
"args": [
"-y",
"@currents/mcp"
]
}
}
}Installer Currents MCP dans VS Code
.vscode/mcp.json
{
"servers": {
"currents-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@currents/mcp"
]
}
}
}Installer Currents MCP dans VS Code CLI
$ code --add-mcp '{"name":"currents-mcp","type":"stdio","command":"npx","args":["-y","@currents/mcp"]}'Installer Currents MCP dans Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"currents-mcp": {
"command": "npx",
"args": [
"-y",
"@currents/mcp"
]
}
}
}Installer Currents MCP dans Codex
$ codex mcp add currents-mcp -- npx -y @currents/mcpInstaller Currents MCP dans Codex config.toml
~/.codex/config.toml
[mcp_servers.currents-mcp] command = "npx" args = ["-y", "@currents/mcp"]
Installer Currents MCP dans Gemini CLI
$ gemini mcp add -s user currents-mcp npx -- -y @currents/mcpInstaller Currents MCP dans Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"currents-mcp": {
"command": "npx",
"args": [
"-y",
"@currents/mcp"
]
}
}
}Outils MCP Currents 43
Détectés depuis le READMEcurrents-list-actionscurrents-create-actioncurrents-get-actioncurrents-update-actioncurrents-delete-actioncurrents-enable-actioncurrents-disable-actioncurrents-list-affected-testscurrents-get-affected-test-executionscurrents-get-action-executionscurrents-get-projectscurrents-get-project
| currents-list-actions | — | |
| currents-create-action | — | |
| currents-get-action | — | |
| 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-get-project | — |
Afficher les 43 outilsAfficher moins d'outils
currents-get-project-insightscurrents-list-pull-requestscurrents-list-project-termscurrents-create-jira-issuecurrents-link-jira-issuecurrents-list-jira-projectscurrents-list-jira-issue-typescurrents-get-runscurrents-get-run-detailscurrents-find-runcurrents-cancel-runcurrents-reset-runcurrents-delete-runcurrents-cancel-run-github-cicurrents-get-spec-instancecurrents-get-spec-files-performancecurrents-get-tests-performancecurrents-get-tests-signaturescurrents-get-test-resultscurrents-get-contextcurrents-get-errors-explorercurrents-get-test-evidencecurrents-create-evidence-linkscurrents-create-sessioncurrents-add-attachmentscurrents-list-webhookscurrents-create-share-linkcurrents-create-webhookcurrents-get-webhookcurrents-update-webhookcurrents-delete-webhook
| currents-get-project-insights | — | |
| currents-list-pull-requests | — | |
| currents-list-project-terms | — | |
| currents-create-jira-issue | — | |
| currents-link-jira-issue | — | |
| currents-list-jira-projects | — | |
| currents-list-jira-issue-types | — | |
| currents-get-runs | — | |
| currents-get-run-details | — | |
| currents-find-run | — | |
| currents-cancel-run | — | |
| currents-reset-run | — | |
| currents-delete-run | — | |
| currents-cancel-run-github-ci | — | |
| currents-get-spec-instance | — | |
| currents-get-spec-files-performance | — | |
| currents-get-tests-performance | — | |
| currents-get-tests-signatures | — | |
| currents-get-test-results | — | |
| currents-get-context | — | |
| currents-get-errors-explorer | — | |
| currents-get-test-evidence | — | |
| currents-create-evidence-links | — | |
| currents-create-session | — | |
| currents-add-attachments | — | |
| currents-list-webhooks | — | |
| currents-create-share-link | — | |
| currents-create-webhook | — | |
| currents-get-webhook | — | |
| currents-update-webhook | — | |
| currents-delete-webhook | — |
Configuration
CURRENTS_API_KEY
| Nom | Description | Type |
|---|---|---|
| CURRENTS_API_KEY | — |
Vérifications automatisées
Exécuté le 12 nov. 2026Rapport complet →A passé nos vérifications automatisées. Il ne s'agit pas d'un audit de sécurité : lisez le code et donnez au serveur l'accès le plus restreint dont il a besoin. Fonctionnement des vérifications
- Dépôt source lié et accessibleRéussi
- Licence open source (OSI)Réussi
- Commit ou version publiée au cours de l'année écouléeRéussi
- Nom du package non proche d'un package populaireRéussi
- L'endpoint distant utilise HTTPSRéussi
- Les outils destructifs sont étiquetésRéussi
- Aucune instruction cachée destinée au modèleRéussi
- Aucun avis critique dans le package ou ses dépendancesNon vérifié
README
Voir sur GitHubCurrents MCP Server
Give your AI coding agents full visibility into your CI test results. The Currents MCP Server connects tools like Cursor and Claude directly to your Currents dashboard, so agents can diagnose flaky tests, pinpoint failures, and act on real execution data -- without leaving your editor.
- Query runs, spec files, and individual test results from CI
- Surface error trends and performance metrics across your test suite
- Manage quarantine rules, webhooks, and project settings programmatically
- Let agents fix what's broken using actual test output, not guesswork
Tools
| Tool | Description |
|---|---|
currents-list-actions |
List all actions for a project with optional filtering. |
currents-create-action |
Create a new action for a project. |
currents-get-action |
Get a single action by ID. |
currents-update-action |
Update an existing action. |
currents-delete-action |
Delete (archive) an action. |
currents-enable-action |
Enable a disabled action. |
currents-disable-action |
Disable an active action. |
currents-list-affected-tests |
List tests affected by actions (quarantine, skip, tag) for a project within a date range. |
currents-get-affected-test-executions |
Keyed on a test: lists the executions of one test that an action applied to, within a date range, with the run, branch and commit of each. |
currents-get-action-executions |
Keyed on an action: lists the test executions one rule was applied to, across every test it touched, within a date range. |
currents-get-projects |
Retrieves projects available in the Currents platform. |
currents-get-project |
Get a single project by ID. |
currents-get-project-insights |
Get aggregated run and test metrics for a project within a date range. |
currents-list-pull-requests |
List pull-request cards for a project (runs grouped by meta.pr.id). |
currents-list-project-terms |
List cursor-paginated project terms for one type (tag, branch, authorName, etc.). |
currents-create-jira-issue |
Create a Jira issue from a run test using the organization Jira integration. |
currents-link-jira-issue |
Link an existing Jira issue to a run test using the organization Jira integration. |
currents-list-jira-projects |
List Jira projects available for the organization integration. |
currents-list-jira-issue-types |
List Jira issue types and custom fields for a Jira project. |
currents-get-runs |
Retrieves a list of runs for a specific project with optional filtering. |
currents-get-run-details |
Retrieves a run: its status, commit, branch, groups and spec files, each with its instanceId, and how many files the run has by level, type and source (attachmentCounts). |
currents-find-run |
Find a run by query parameters. |
currents-cancel-run |
Cancel a run in progress. |
currents-reset-run |
Reset failed spec files in a run to allow re-execution. |
currents-delete-run |
Delete a run and all associated data. |
currents-cancel-run-github-ci |
Cancel a run by GitHub Actions workflow run ID and attempt number. |
currents-get-spec-instance |
Retrieves the raw result of one spec file execution by instanceId: each test's state and attempts, and the artifact URLs. |
currents-get-spec-files-performance |
Retrieves spec files performance metrics for a specific project within a date range. |
currents-get-tests-performance |
Retrieves aggregated test metrics for a specific project within a date range. |
currents-get-tests-signatures |
Generates a unique test signature based on project, spec file path, and test title. |
currents-get-test-results |
Retrieves historical test execution results for a specific test signature. |
currents-get-context |
Call this first to find out why tests failed in CI, or to fix them: returns the errors, steps and files of the failed tests of a run, a spec file (instance) or one test — the same content as Fix in the Currents dashboard. |
currents-get-errors-explorer |
Get aggregated error metrics for a project within a date range. |
currents-get-test-evidence |
Collect evidence artifacts (screenshots, videos, traces, attachments) produced by tests in a CI run, with signed download URLs grouped per test. |
currents-create-evidence-links |
Create a shareable trace API link to a test attempt's evidence, served from its Playwright trace, and the URLs onto it: a markdown trace summary (the digest URL) of what the attempt did and what failed, a filmstrip, an animated screencast, DOM snapshots, network requests and attachments. |
currents-create-session |
Record a browser session you drove as a Currents session, so its evidence can be read and shared. |
currents-add-attachments |
Add attachments to a session from currents-create-session (send sessionId), or to a CI run (send runId): logs for a spec file, a test, or the run itself. |
currents-list-webhooks |
List all webhooks for a project. |
currents-create-share-link |
Create a public link to test results that anyone can open without signing in, until it expires. purpose "fix" is the failure context, for an agent that will fix the tests — the same content as currents-get-context, with flaky tests included and marked flaky. purpose "report" lists every test with its attempts and files, for a person; for a session it is the session page: status, error, attachments and trace. |
currents-create-webhook |
Create a new webhook for a project. |
currents-get-webhook |
Get a single webhook by ID. |
currents-update-webhook |
Update an existing webhook. |
currents-delete-webhook |
Delete a webhook. |
Skills
Agent skills that teach AI agents multi-step Currents workflows.
| Skill | Description |
|---|---|
browser-evidence |
Experimental: prove a change works in a browser you drove yourself, when there is no test to run. |
collect-evidence |
Show that work you implemented actually works, or demo it, from tests that ran in CI via Currents — a trace API link whose trace summary, filmstrip and accessibility snapshots read inside a comment, plus screenshots, attachments and videos. |
fix-failing-tests |
Fix tests that failed in CI, using the results Currents recorded — errors, steps, traces, screenshots and console output. |
The server publishes every skill as an MCP resource, so a connected agent can list and read them without a local copy:
skill://currents/collect-evidence/SKILL.md
skill://currents/collect-evidence/references/instrumentation.md
Agents that load skills only from disk still need a copy — put the skill
directory in the agent's skills location (e.g. .claude/skills/ for Claude
Code).
Setup
API Key
Get a Currents API key by following the instructions here.
Usage with Cursor
- Go to Cursor Settings > MCP > Enable
- Add the following to your
mcp.json.
{
"mcpServers": {
"currents": {
"command": "npx",
"args": ["-y", "@currents/mcp"],
"env": {
"CURRENTS_API_KEY": "your-api-key"
}
}
}
}
Questions sur Currents MCP
Comment ajouter Currents MCP à Claude Code ?
Exécutez claude mcp add currents-mcp -- npx -y @currents/mcp dans votre terminal. Ajoutez --scope user pour le rendre disponible dans tous les projets.
Comment ajouter Currents MCP à Cursor ?
Ouvrez ~/.cursor/mcp.json et ajoutez le serveur sous mcpServers, avec la configuration Cursor indiquée dans la section d'installation ci-dessus.
Quels outils Currents MCP fournit-il ?
Il expose 43 outils, dont currents-list-actions, currents-create-action, currents-get-action, currents-update-action, currents-delete-action.
Que permet de faire le MCP server de Currents pour les agents IA ?
Il connecte les agents de codage au tableau de bord Currents pour qu'ils puissent interroger les exécutions, les fichiers de spécification et les résultats de tests, identifier les tendances d'erreurs et gérer les règles de quarantaine ainsi que les paramètres du projet.
Les agents peuvent-ils créer ou lier des tickets Jira via ce serveur ?
Oui, le serveur inclut des outils pour créer un ticket Jira à partir d'un test d'exécution, lier un ticket Jira existant et lister les projets et les types de tickets Jira.
Puis-je gérer les règles de quarantaine et d'omission avec ce MCP server ?
Oui, des outils permettent aux agents de lister, créer, mettre à jour, supprimer, activer et désactiver des actions telles que les règles de quarantaine, d'omission (skip) et de marquage (tag) pour un projet.
Est-ce compatible avec Cursor et Claude ?
Le Currents MCP Server est conçu pour connecter des outils comme Cursor et Claude à votre tableau de bord Currents.