Currents

Currents MCP Server

Gib deinen KI-Codierungsagenten volle Einblicke in deine CI-Testergebnisse. Der Currents MCP Server verbindet Tools wie Cursor und Claude direkt mit deinem Currents-Dashboard, sodass Agenten flaky Tests diagnostizieren, Fehler gezielt eingrenzen und auf Basis echter Ausführungsdaten handeln können – ohne deinen Editor zu verlassen.

• Fragt Runs, Spec-Dateien und einzelne Testergebnisse aus CI ab
• Deckt Fehlertrends und Leistungskennzahlen in deiner Testsuite auf
• Verwaltet Quarantäne-Regeln, Webhooks und Projekteinstellungen programmatisch
• Lass Agenten das Beheben, was defekt ist – anhand tatsächlicher Testausgaben, nicht durch Raten

Tools

Tool	Beschreibung
currents-list-actions	Alle Aktionen für ein Projekt auflisten, mit optionaler Filterung.
currents-create-action	Eine neue Aktion für ein Projekt erstellen.
currents-get-action	Eine einzelne Aktion anhand der ID abrufen.
currents-update-action	Eine bestehende Aktion aktualisieren.
currents-delete-action	Eine Aktion löschen (archivieren).
currents-enable-action	Eine deaktivierte Aktion aktivieren.
currents-disable-action	Eine aktive Aktion deaktivieren.
currents-list-affected-tests	Tests auflisten, die von Aktionen betroffen sind (Quarantäne, Überspringen, Tag) für ein Projekt innerhalb eines Datumsbereichs.
currents-get-affected-test-executions	Schlüssel auf einem Test: listet die Ausführungen eines Tests auf, auf die eine Aktion angewendet wurde, innerhalb eines Datumsbereichs, mit dem Run, Branch und Commit jeder Ausführung.
currents-get-action-executions	Schlüssel auf einer Aktion: listet die Testausführungen auf, auf die eine Regel angewendet wurde, über alle betroffenen Tests hinweg, innerhalb eines Datumsbereichs.
currents-get-projects	Ruft Projekte ab, die in der Currents-Plattform verfügbar sind.
currents-get-project	Ein einzelnes Projekt anhand der ID abrufen.
currents-get-project-insights	Aggregierte Run- und Testmetriken für ein Projekt innerhalb eines Datumsbereichs abrufen.
currents-list-pull-requests	Pull-Request-Karten für ein Projekt auflisten (Runs gruppiert nach meta.pr.id).
currents-list-project-terms	Cursor-paginierte Projektbegriffe für einen Typ auflisten (tag, branch, authorName, usw.).
currents-create-jira-issue	Ein Jira-Ticket aus einem Run-Test erstellen, unter Verwendung der Jira-Integration der Organisation.
currents-link-jira-issue	Ein bestehendes Jira-Ticket mit einem Run-Test verknüpfen, unter Verwendung der Jira-Integration der Organisation.
currents-list-jira-projects	Jira-Projekte auflisten, die für die Integration der Organisation verfügbar sind.
currents-list-jira-issue-types	Jira-Tickettypen und benutzerdefinierte Felder für ein Jira-Projekt auflisten.
currents-get-runs	Ruft eine Liste von Runs für ein bestimmtes Projekt mit optionaler Filterung ab.
currents-get-run-details	Ruft Details eines bestimmten Test-Runs ab.
currents-find-run	Einen Run anhand von Abfrageparametern finden.
currents-cancel-run	Einen laufenden Run abbrechen.
currents-reset-run	Fehlgeschlagene Spec-Dateien in einem Run zurücksetzen, um eine erneute Ausführung zu ermöglichen.
currents-delete-run	Einen Run und alle zugehörigen Daten löschen.
currents-cancel-run-github-ci	Einen Run anhand der GitHub-Actions-Workflow-Run-ID und der Versuchsnummer abbrechen.
currents-get-spec-instance	Ruft Debugging-Daten von einer bestimmten Ausführung einer Test-Spec-Datei anhand der instanceId ab.
currents-get-spec-files-performance	Ruft Leistungsmetriken von Spec-Dateien für ein bestimmtes Projekt innerhalb eines Datumsbereichs ab.
currents-get-tests-performance	Ruft aggregierte Testmetriken für ein bestimmtes Projekt innerhalb eines Datumsbereichs ab.
currents-get-tests-signatures	Generiert eine eindeutige Testsignatur basierend auf Projekt, Spec-Dateipfad und Testtitel.
currents-get-test-results	Ruft historische Testausführungsergebnisse für eine bestimmte Testsigatur ab.
currents-get-context	Verwenden Sie dies, um Tests zu beheben, die in CI fehlgeschlagen sind: Gibt die Fehler, Schritte und Dateien der fehlgeschlagenen Tests eines Laufs, einer Spezifikationsdatei (Instanz) oder eines einzelnen Tests zurück – derselbe Inhalt wie „Fix" im Currents-Dashboard.
currents-get-errors-explorer	Ruft aggregierte Fehlermetriken für ein Projekt innerhalb eines Datumsbereichs ab.
currents-get-test-evidence	Sammelt Beweisartefakte (Screenshots, Videos, Traces, Anhänge), die von Tests in einem CI-Lauf erzeugt wurden, mit signierten Download-URLs, gruppiert pro Test.
currents-create-evidence-links	Erstellt einen teilbaren Link zu den Beweisen eines Testversuchs, bereitgestellt aus dessen Playwright-Trace, sowie die URLs darauf: eine Markdown-Zusammenfassung dessen, was der Versuch getan hat und was fehlgeschlagen ist, ein Filmstreifen, ein animierter Screencast, DOM-Snapshots, Netzwerkanfragen und Anhänge.
currents-create-session	Zeichnet eine Browsersitzung, die Sie gesteuert haben, als Currents-Lauf auf, sodass deren Beweise wie die eines CI-Laufs gelesen und geteilt werden können.
currents-list-webhooks	Listet alle Webhooks für ein Projekt auf.
currents-create-share-link	Erstellt einen öffentlichen Link zu Testergebnissen, den jeder ohne Anmeldung öffnen kann, bis er abläuft. Zweck „fix" ist der Fehlerkontext für einen Agenten, der die Tests beheben wird – derselbe Inhalt wie currents-get-context, einschließlich flaky Tests, die als flaky markiert sind. Zweck „report" listet jeden Test mit seinen Versuchen und Dateien auf, für eine Person.
currents-create-webhook	Erstellt einen neuen Webhook für ein Projekt.
currents-get-webhook	Ruft einen einzelnen Webhook anhand seiner ID ab.
currents-update-webhook	Aktualisiert einen vorhandenen Webhook.
currents-delete-webhook	Löscht einen Webhook.

Fähigkeiten

Agent-Fähigkeiten, die KI-Agenten mehrstufige Currents-Workflows beibringen.

Fähigkeit	Beschreibung
browser-evidence	Experimentell.
collect-evidence	Zeigen, dass implementierte Arbeit tatsächlich funktioniert, oder sie demonstrieren, anhand von Tests, die in CI über Currents liefen — ein Trace-Link, dessen Digest, Filmstrip und Accessibility-Snapshots in einem Kommentar gelesen werden, plus Screenshots, Anhänge und Videos.
fix-failing-tests	Tests reparieren, die in CI fehlgeschlagen sind, mithilfe der von Currents aufgezeichneten Ergebnisse — Fehler, Schritte, Traces, Screenshots und Konsolenausgabe.

Der Server veröffentlicht jede Fähigkeit als MCP-Ressource, sodass ein verbundener Agent sie ohne lokale Kopie auflisten und lesen kann:

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

Agenten, die Fähigkeiten nur von der Festplatte laden, benötigen weiterhin eine Kopie — legen Sie das Fähigkeiten-Verzeichnis am Speicherort des Agenten ab (z. B. .claude/skills/ für Claude Code).

Einrichtung

API-Schlüssel

Holen Sie sich einen Currents-API-Schlüssel, indem Sie den Anweisungen hier folgen.

Verwendung mit Cursor

1. Gehen Sie zu Cursor-Einstellungen > MCP > Aktivieren
2. Fügen Sie Folgendes zu Ihrer mcp.json hinzu.

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

Claude

Führen Sie diesen Befehl aus, um Currents MCP zu Claude Code hinzuzufügen

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

Fügen Sie Folgendes hinzu, um Currents MCP auf Claude Desktop zu aktivieren (bearbeiten Sie die Datei claude_desktop_config.json):

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

Remote (gehosteter) MCP-Endpunkt

Zusätzlich zum lokalen Stdio-Transport oben kann derselbe Server als gehosteter Streamable-HTTP-Endpunkt (z. B. https://mcp.currents.dev/mcp) für die Verwendung mit Remote- Verbindungen wie den Claude-Web-/Mobil-Apps ausgeführt werden.

Der gehostete Server führt keine eigene Authentifizierung durch. Jede Anfrage muss Ihren Currents-API-Schlüssel als Bearer-Token enthalten, das an die Currents-API weitergeleitet wird:

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

Beispiel-Client-Konfiguration (Remote-Verbindung):

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

Den HTTP-Server selbst ausführen:

# 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

Der Node-Server spricht einfaches HTTP; TLS und die öffentliche Domain enden am Reverse-Proxy / Load Balancer vor dem Container. Ein GET /healthz-Endpunkt ist für Liveness-Checks vorgesehen.

⚠️ Hinweis

Durch die Verbindung von KI-Tools (z. B. über MCP) mit Currents gewähren Sie ihnen Zugriff auf Ihren API-Schlüssel, Testergebnisse und CI-Metadaten. Es liegt in Ihrer Verantwortung, alle KI-Agenten oder -Dienste, die Sie verwenden, zu prüfen und sicherzustellen, dass sie Ihre Daten sicher verarbeiten.

Referenzen

• Currents
• Currents-Dokumentation
• Beitragsleitfaden
• Veröffentlichen und Publizieren
• Lizenz