Currents

Serveur MCP Currents

Donnez à vos agents de codage IA une visibilité complète sur vos résultats de tests CI. Le serveur MCP Currents connecte des outils comme Cursor et Claude directement à votre tableau de bord Currents, afin que les agents puissent diagnostiquer les tests instables, identifier les échecs et agir sur des données d'exécution réelles — sans quitter votre éditeur.

• Interrogez les exécutions, les fichiers spec et les résultats de tests individuels depuis la CI
• Révélez les tendances d'erreurs et les métriques de performance de votre suite de tests
• Gérez les règles de quarantaine, les webhooks et les paramètres de projet par programmation
• Laissez les agents corriger ce qui est cassé en utilisant les sorties de tests réelles, pas des suppositions

Outils

Outil	Description
currents-list-actions	Liste toutes les actions d'un projet avec filtrage optionnel.
currents-create-action	Crée une nouvelle action pour un projet.
currents-get-action	Récupère une action par son ID.
currents-update-action	Met à jour une action existante.
currents-delete-action	Supprime (archive) une action.
currents-enable-action	Active une action désactivée.
currents-disable-action	Désactive une action active.
currents-list-affected-tests	Liste les tests affectés par des actions (quarantaine, skip, tag) pour un projet dans une plage de dates.
currents-get-affected-test-executions	Récupère les détails d'exécution d'un test affecté spécifique (par signature) dans une plage de dates.
currents-get-affected-executions	Liste les exécutions de tests où une action/règle spécifique a été appliquée, dans une plage de dates.
currents-get-projects	Récupère les projets disponibles sur la plateforme Currents.
currents-get-project	Récupère un projet par son ID.
currents-get-project-insights	Récupère les métriques agrégées d'exécutions et de tests pour un projet dans une plage de dates.
currents-list-pull-requests	Liste les cartes de pull-request pour un projet (exécutions groupées par meta.pr.id).
currents-list-project-terms	Liste les termes de projet paginés par curseur pour un type (tag, branche, authorName, etc.).
currents-create-jira-issue	Crée un ticket Jira à partir d'un test d'exécution en utilisant l'intégration Jira de l'organisation.
currents-link-jira-issue	Lie un ticket Jira existant à un test d'exécution en utilisant l'intégration Jira de l'organisation.
currents-list-jira-projects	Liste les projets Jira disponibles pour l'intégration de l'organisation.
currents-list-jira-issue-types	Liste les types de tickets Jira et les champs personnalisés pour un projet Jira.
currents-get-runs	Récupère une liste d'exécutions pour un projet spécifique avec filtrage optionnel.
currents-get-run-details	Récupère les détails d'une exécution de test spécifique.
currents-find-run	Trouve une exécution par paramètres de requête.
currents-cancel-run	Annule une exécution en cours.
currents-reset-run	Réinitialise les fichiers spec en échec dans une exécution pour permettre une nouvelle exécution.
currents-delete-run	Supprime une exécution et toutes les données associées.
currents-cancel-run-github-ci	Annule une exécution par ID d'exécution de workflow GitHub Actions et numéro de tentative.
currents-get-spec-instance	Récupère les données de débogage d'une exécution spécifique d'un fichier spec de test par instanceId.
currents-get-spec-files-performance	Récupère les métriques de performance des fichiers spec pour un projet spécifique dans une plage de dates.
currents-get-tests-performance	Récupère les métriques de tests agrégées pour un projet spécifique dans une plage de dates.
currents-get-tests-signatures	Génère une signature de test unique basée sur le projet, le chemin du fichier spec et le titre du test.
currents-get-test-results	Récupère les résultats d'exécution de tests historiques pour une signature de test spécifique.
currents-get-context	Récupère le contexte d'échec de test pour le débogage IA au niveau de l'exécution, de l'instance ou du test.
currents-get-errors-explorer	Récupère les métriques d'erreurs agrégées pour un projet dans une plage de dates.
currents-get-test-evidence	Collecte les artefacts de preuve (captures d'écran, vidéos, traces, pièces jointes) produits par les tests dans une exécution CI, avec des URL de téléchargement signées groupées par test.
currents-list-webhooks	Liste tous les webhooks d'un projet.
currents-create-webhook	Crée un nouveau webhook pour un projet.
currents-get-webhook	Récupère un webhook par son ID.
currents-update-webhook	Met à jour un webhook existant.
currents-delete-webhook	Supprime un webhook.

Compétences

Compétences d'agent qui enseignent aux agents IA les workflows Currents en plusieurs étapes.

Compétence	Description
collect-evidence	Montrez que le travail implémenté fonctionne, ou faites-en une démo, en utilisant les artefacts de tests CI — captures d'écran avant/après, pièces jointes texte, vidéos, traces.

Le serveur publie chaque compétence en tant que ressource MCP, afin qu'un agent connecté puisse les lister et les lire sans copie locale :

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

Les agents qui chargent les compétences uniquement depuis le disque ont toujours besoin d'une copie — placez le répertoire de compétences dans l'emplacement des compétences de l'agent (par ex. .claude/skills/ pour Claude Code).

Configuration

Clé API

Obtenez une clé API Currents en suivant les instructions ici.

Utilisation avec Cursor

1. Allez dans Cursor Settings > MCP > Enable
2. Ajoutez ce qui suit à votre mcp.json.

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

Claude

Exécutez cette commande pour ajouter Currents MCP à Claude Code

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

Ajoutez ce qui suit pour activer Currents MCP sur Claude Desktop (modifiez le fichier claude_desktop_config.json) :

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

Point de terminaison MCP distant (hébergé)

En plus du transport stdio local ci-dessus, le même serveur peut fonctionner comme un point de terminaison HTTP Streamable hébergé (par ex. https://mcp.currents.dev/mcp) pour une utilisation avec des connecteurs distants tels que les applications web/mobiles Claude.

Le serveur hébergé n'effectue aucune authentification propre. Chaque requête doit transporter votre clé API Currents comme jeton Bearer, qui est transmis à l'API Currents :

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

Exemple de configuration client (connecteur distant) :

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

Exécution du serveur HTTP vous-même :

# 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

Le serveur Node parle en HTTP simple ; TLS et le domaine public se terminent au niveau du proxy inverse / équilibreur de charge devant le conteneur. Un point de terminaison GET /healthz est fourni pour les vérifications de disponibilité.

⚠️ Avis

En connectant des outils IA (par ex., via MCP) à Currents, vous leur accordez l'accès à votre clé API, vos résultats de tests et vos métadonnées CI. Il vous incombe de vérifier les agents ou services IA que vous utilisez et de vous assurer qu'ils traitent vos données en toute sécurité.

Références

• Currents
• Documentation Currents
• Guide de contribution
• Publication et diffusion
• Licence