Currents

Currents MCP Server

Geben Sie Ihren KI-Codierungsagenten volle Einblicke in Ihre CI-Testergebnisse. Der Currents MCP Server verbindet Tools wie Cursor und Claude direkt mit Ihrem Currents Dashboard, sodass Agenten flaky Tests diagnostizieren, Fehler lokalisieren und auf Basis echter Ausführungsdaten handeln können – ohne Ihren Editor zu verlassen.

• Runs, Spec-Dateien und einzelne Testergebnisse aus CI abfragen
• Fehlertrends und Leistungsmetriken über Ihre Testsuite hinweg aufzeigen
• Quarantäneregeln, Webhooks und Projekteinstellungen programmatisch verwalten
• Agenten das Beheben von Fehlern anhand tatsächlicher Testausgaben ermöglichen, statt zu raten

Werkzeuge

Werkzeug	Beschreibung
currents-list-actions	Listet alle Aktionen für ein Projekt mit optionaler Filterung auf.
currents-create-action	Erstellt eine neue Aktion für ein Projekt.
currents-get-action	Ruft eine einzelne Aktion anhand der ID ab.
currents-update-action	Aktualisiert eine vorhandene Aktion.
currents-delete-action	Löscht (archiviert) eine Aktion.
currents-enable-action	Aktiviert eine deaktivierte Aktion.
currents-disable-action	Deaktiviert eine aktive Aktion.
currents-list-affected-tests	Listet Tests auf, die von Aktionen (Quarantäne, Überspringen, Tag) betroffen sind, für ein Projekt innerhalb eines Datumsbereichs.
currents-get-affected-test-executions	Ruft Ausführungsdetails für einen bestimmten betroffenen Test (per Signatur) innerhalb eines Datumsbereichs ab.
currents-get-affected-executions	Listet Testausführungen auf, bei denen eine bestimmte Aktion/Regel angewendet wurde, innerhalb eines Datumsbereichs.
currents-get-projects	Ruft Projekte ab, die in der Currents-Plattform verfügbar sind.
currents-get-project	Ruft ein einzelnes Projekt anhand der ID ab.
currents-get-project-insights	Ruft aggregierte Run- und Testmetriken für ein Projekt innerhalb eines Datumsbereichs ab.
currents-list-pull-requests	Listet Pull-Request-Karten für ein Projekt auf (Runs gruppiert nach meta.pr.id).
currents-list-project-terms	Listet cursor-paginierte Projektbegriffe für einen Typ auf (Tag, Branch, authorName usw.).
currents-create-jira-issue	Erstellt ein Jira-Ticket aus einem Run-Test mithilfe der Jira-Integration der Organisation.
currents-link-jira-issue	Verknüpft ein vorhandenes Jira-Ticket mit einem Run-Test mithilfe der Jira-Integration der Organisation.
currents-list-jira-projects	Listet Jira-Projekte auf, die für die Organisationsintegration verfügbar sind.
currents-list-jira-issue-types	Listet Jira-Tickettypen und benutzerdefinierte Felder für ein Jira-Projekt auf.
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	Findet einen Run anhand von Abfrageparametern.
currents-cancel-run	Bricht einen laufenden Run ab.
currents-reset-run	Setzt fehlgeschlagene Spec-Dateien in einem Run zurück, um eine erneute Ausführung zu ermöglichen.
currents-delete-run	Löscht einen Run und alle zugehörigen Daten.
currents-cancel-run-github-ci	Bricht einen Run anhand der GitHub-Actions-Workflow-Run-ID und der Versuchsnummer ab.
currents-get-spec-instance	Ruft Debugging-Daten aus 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 Testsignatur ab.
currents-get-context	Ruft den Kontext von Testfehlern für KI-Debugging auf Run-, Instanz- oder Testebene ab.
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-Run erzeugt wurden, mit signierten Download-URLs, gruppiert pro Test.
currents-list-webhooks	Listet alle Webhooks für ein Projekt auf.
currents-create-webhook	Erstellt einen neuen Webhook für ein Projekt.
currents-get-webhook	Ruft einen einzelnen Webhook anhand der ID ab.
currents-update-webhook	Aktualisiert einen vorhandenen Webhook.
currents-delete-webhook	Löscht einen Webhook.

Fähigkeiten

Agentenfähigkeiten, die KI-Agenten mehrstufige Currents-Workflows vermitteln.

Fähigkeit	Beschreibung
collect-evidence	Zeigen, dass implementierte Arbeit funktioniert, oder sie demonstrieren, mithilfe von CI-Testartefakten – Vorher/Nachher-Screenshots, Textanhänge, Videos, Traces.

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ähigkeitenverzeichnis am Speicherort für Agentenfähigkeiten ab (z. B. .claude/skills/ für Claude Code).

Einrichtung

API-Schlüssel

Erhalten Sie 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-Konnektoren 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, der an die Currents-API weitergeleitet wird:

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

Beispiel-Client-Konfiguration (Remote-Konnektor):

{
  "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 wird für Liveness-Checks bereitgestellt.

⚠️ 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 von Ihnen verwendeten KI-Agenten oder Dienste zu prüfen und sicherzustellen, dass sie Ihre Daten sicher verarbeiten.

Referenzen

• Currents
• Currents-Dokumentation
• Beitragsleitfaden
• Veröffentlichung und Publikation
• Lizenz