DeepSource MCP-Server

Ein Model Context Protocol (MCP)-Server, der in DeepSource integriert ist, um KI-Assistenten Zugriff auf Codequalitätsmetriken, Probleme und Analyseergebnisse zu bieten.

Überblick

Der DeepSource MCP Server ermöglicht KI-Assistenten die Interaktion mit den Codequalitätsanalysefunktionen von DeepSource über das Model Context Protocol. Diese Integration ermöglicht KI-Assistenten:

• Abrufen von Codemetriken und Analyseergebnissen

• Zugriffs- und Filterprobleme

• Qualitätsstatus prüfen

• Analysieren Sie die Projektqualität im Zeitverlauf

Merkmale

• DeepSource-API-Integration : Verbindung mit DeepSource über die GraphQL-API

• MCP-Protokollunterstützung : Implementiert das Model Context Protocol für die Integration von KI-Assistenten

• Qualitätsmetriken und Schwellenwerte : Abrufen und Verwalten von Codequalitätsmetriken mit Schwellenwerten

• Sicherheits-Compliance-Berichte : Zugriff auf OWASP Top 10, SANS Top 25 und MISRA-C Compliance-Berichte

• Abhängigkeitsschwachstellen : Zugriff auf Informationen zu Sicherheitsschwachstellen in Abhängigkeiten

• TypeScript/Node.js : Erstellt mit TypeScript für Typsicherheit und moderne JavaScript-Funktionen

• Plattformübergreifend : Funktioniert unter Linux, macOS und Windows

• Robuste Fehlerbehandlung : Umfassende Fehlerbehandlung für Netzwerk-, Authentifizierungs- und Analyseprobleme

Verwendung mit Claude Desktop

1. Bearbeiten Sie claude_desktop_config.json :

   • Öffnen Sie Claude Desktop

   • Gehen Sie zu Settings -> Developer -> Edit Config

   • Fügen Sie eine der folgenden Konfigurationen zum Abschnitt mcpServers hinzu

2. Starten Sie Claude Desktop neu, um die Änderungen zu übernehmen

Beispielabfragen

Sobald die Verbindung hergestellt ist, kann Ihr KI-Assistent DeepSource-Daten mit Abfragen wie den folgenden verwenden:

Dies würde das Tool project_issues mit Filtern verwenden:

So filtern Sie Analyseläufe:

Dies würde das Tool project_runs mit Filtern verwenden:

Für Codequalitätsmetriken:

Dazu würde das Tool quality_metrics verwendet:

Für Sicherheitskonformitätsberichte:

Dazu würde das Tool compliance_report verwendet:

So legen Sie Schwellenwerte fest:

Dies würde das Tool update_metric_threshold verwenden:

Umgebungsvariablen

Der Server unterstützt die folgenden Umgebungsvariablen:

• DEEPSOURCE_API_KEY (erforderlich): Ihr DeepSource-API-Schlüssel zur Authentifizierung

• LOG_FILE (optional): Pfad zu einer Datei, in die Protokolle geschrieben werden sollen. Wenn nicht angegeben, werden keine Protokolle geschrieben.

• LOG_LEVEL (optional): Minimale Protokollebene zum Schreiben (DEBUG, INFO, WARN, ERROR). Standardmäßig DEBUG

Beispielkonfiguration mit Protokollierung:

Docker

NPX

Verfügbare Tools

Der DeepSource MCP-Server bietet die folgenden Tools:

1. projects : Listet alle verfügbaren DeepSource-Projekte auf

   • Parameter:

     • Keine erforderlichen Parameter

2. project_issues : Holen Sie sich Probleme aus einem DeepSource-Projekt mit Filterung

   • Parameter:

     • projectKey (erforderlich) – Die eindeutige Kennung für das DeepSource-Projekt

     • Paginierungsparameter:

       • offset (optional) – Anzahl der Elemente, die bei der Paginierung übersprungen werden sollen

       • first (optional) – Anzahl der zurückzugebenden Elemente (Standardwert: 10)

       • after (optional) - Cursor für die Vorwärtspaginierung

       • before (optional) - Cursor für die Rückwärtspaginierung

       • last (optional) – Anzahl der Elemente, die vor dem Cursor „vor“ zurückgegeben werden sollen (Standard: 10)

     • Filterparameter:

       • path (optional) – Filtern Sie Probleme nach einem bestimmten Dateipfad

       • analyzerIn (optional) – Filtern Sie Probleme nach bestimmten Analysatoren (z. B. ["python", "javascript"])

       • tags (optional) – Probleme nach Tags filtern

3. project_runs : Listenanalyseläufe für ein DeepSource-Projekt mit Filterung

   • Parameter:

     • projectKey (erforderlich) – Die eindeutige Kennung für das DeepSource-Projekt

     • Paginierungsparameter:

       • offset (optional) – Anzahl der Elemente, die bei der Paginierung übersprungen werden sollen

       • first (optional) – Anzahl der zurückzugebenden Elemente (Standardwert: 10)

       • after (optional) - Cursor für die Vorwärtspaginierung

       • before (optional) - Cursor für die Rückwärtspaginierung

       • last (optional) – Anzahl der Elemente, die vor dem Cursor „vor“ zurückgegeben werden sollen (Standard: 10)

     • Filterparameter:

       • analyzerIn (optional) – Filter, der von bestimmten Analysatoren ausgeführt wird (z. B. ["python", "javascript"])

4. run : Rufen Sie eine bestimmte Analyse ab, die über ihre runUid oder commitOid ausgeführt wird.

   • Parameter:

     • runIdentifier (erforderlich) – Die runUid (UUID) oder commitOid (Commit-Hash) zur Identifizierung des Laufs

5. recent_run_issues : Ruft Probleme aus der letzten Analyse ab, die auf einem bestimmten Zweig mit Paginierungsunterstützung ausgeführt wurde.

   • Parameter:

     • projectKey (erforderlich) – Die eindeutige Kennung für das DeepSource-Projekt

     • branchName (erforderlich) – Der Name des Zweigs, aus dem der letzte Lauf abgerufen werden soll

     • Paginierungsparameter:

       • first (optional) – Anzahl der zurückzugebenden Probleme (Standardwert: 10)

       • after (optional) - Cursor für die Vorwärtspaginierung

       • last (optional) – Anzahl der Probleme, die vor einem Cursor zurückgegeben werden sollen (Standard: 10)

       • before (optional) - Cursor für die Rückwärtspaginierung

   • Widerrufsfolgen:

     • Informationen zum letzten Lauf auf der Filiale

     • Aktuelle Probleme im Projekt (Hinweis: Probleme treten auf Repository-Ebene auf, nicht laufspezifisch)

     • Paginierungsinformationen einschließlich Cursor und Seitenstatus

     • Metadaten zum Lauf und zum Zweig

6. dependency_vulnerabilities : Abhängigkeitsschwachstellen aus einem DeepSource-Projekt abrufen

   • Parameter:

     • projectKey (erforderlich) – Die eindeutige Kennung für das DeepSource-Projekt

     • Paginierungsparameter:

       • offset (optional) – Anzahl der Elemente, die bei der Paginierung übersprungen werden sollen

       • first (optional) – Anzahl der zurückzugebenden Elemente (Standardwert: 10)

       • after (optional) - Cursor für die Vorwärtspaginierung

       • before (optional) - Cursor für die Rückwärtspaginierung

       • last (optional) – Anzahl der Elemente, die vor dem Cursor „vor“ zurückgegeben werden sollen (Standard: 10)

7. quality_metrics : Holen Sie Qualitätsmetriken aus einem DeepSource-Projekt mit Filterung

   • Parameter:

     • projectKey (erforderlich) – Die eindeutige Kennung für das DeepSource-Projekt

     • shortcodeIn (optional) – Filtern Sie Metriken nach bestimmten Shortcodes (z. B. ["LCV", "BCV"])

   • Gibt Kennzahlen zurück wie:

     • Linienabdeckung (LCV)

     • Filialabdeckung (BCV)

     • Dokumentationsumfang (DCV)

     • Prozentsatz doppelter Codes (DDP)

     • Jede Metrik umfasst aktuelle Werte, Schwellenwerte und den Pass/Fail-Status

8. update_metric_threshold : Aktualisieren Sie den Schwellenwert für eine bestimmte Qualitätsmetrik

   • Parameter:

     • projectKey (erforderlich) – Die eindeutige Kennung für das DeepSource-Projekt

     • repositoryId (erforderlich) – Die GraphQL-Repository-ID

     • metricShortcode (erforderlich) – Der Shortcode der zu aktualisierenden Metrik

     • metricKey (erforderlich) – Der Sprach- oder Kontextschlüssel für die Metrik

     • thresholdValue (optional) - Der neue Schwellenwert oder null, um den Schwellenwert zu entfernen

   • Beispiel: Festlegen eines Schwellenwerts für die Zeilenabdeckung von 80 %: metricShortcode="LCV", metricKey="AGGREGATE", thresholdValue=80

9. update_metric_setting : Aktualisieren Sie die Einstellungen für eine Qualitätsmetrik

   • Parameter:

     • projectKey (erforderlich) – Die eindeutige Kennung für das DeepSource-Projekt

     • repositoryId (erforderlich) – Die GraphQL-Repository-ID

     • metricShortcode (erforderlich) – Der Shortcode der zu aktualisierenden Metrik

     • isReported (erforderlich) – Ob die Metrik gemeldet werden soll

     • isThresholdEnforced (erforderlich) – Ob der Schwellenwert erzwungen werden soll (kann bei Prüfungen fehlschlagen)

10. compliance_report : Erhalten Sie Sicherheits-Compliance-Berichte von einem DeepSource-Projekt

• Parameter:

  • projectKey (erforderlich) – Die eindeutige Kennung für das DeepSource-Projekt

  • reportType (erforderlich) – Der Typ des abzurufenden Compliance-Berichts ( OWASP Top 10 , SANS Top 25 oder MISRA-C )

• Gibt umfassende Daten zur Sicherheitskonformität zurück, darunter:

  • Statistiken zu Sicherheitsproblemen nach Kategorie und Schweregrad

  • Konformitätsstatus (bestanden/nicht bestanden)

  • Trenddaten, die Veränderungen im Zeitverlauf zeigen

  • Analyse und Empfehlungen zur Verbesserung der Sicherheitslage

Entwicklung

1. Klonen Sie das Repository:

2. Installieren Sie Abhängigkeiten:

3. Erstellen Sie das Projekt:

4. Claude Desktop konfigurieren

Voraussetzungen

• Node.js 20 oder höher

• pnpm 10.7.0 oder höher

• Docker (für Container-Builds)

Skripte

• pnpm run build – Erstellen Sie den TypeScript-Code

• pnpm run start - Starten Sie den Server

• pnpm run dev - Starten Sie den Server im Entwicklungsmodus

• pnpm run test – Tests ausführen

• pnpm run lint – ESLint ausführen

• pnpm run format - Code mit Prettier formatieren

Fehlerbehebung

Debug-Protokollierung aktivieren

Wenn Probleme auftreten, aktivieren Sie die Debug-Protokollierung, um ausführliche Informationen anzuzeigen:

1. Setzen Sie die Umgebungsvariable LOG_FILE auf einen Dateipfad, in den Protokolle geschrieben werden sollen

2. Setzen Sie LOG_LEVEL auf DEBUG (das ist die Standardeinstellung)

3. Überprüfen Sie die Protokolldatei auf detaillierte Fehlerinformationen

Beispielkonfiguration:

Überprüfen Sie dann die Protokolldatei:

Häufige Probleme

1. Authentifizierungsfehler : Stellen Sie sicher, dass Ihr DEEPSOURCE_API_KEY korrekt ist und über die erforderlichen Berechtigungen verfügt

2. Es werden keine Protokolle angezeigt : Überprüfen Sie, ob der LOG_FILE Pfad beschreibbar ist und das übergeordnete Verzeichnis vorhanden ist

3. Tool-Fehler : Überprüfen Sie die Protokolldatei auf detaillierte Fehlermeldungen und Stapelverfolgungen

Lizenz

MIT