return0 MCP Server

offiziell

Debuggen Sie Ihre entfernten Node.js- und Next.js-Anwendungen direkt aus Ihrer KI-IDE wie Cursor.

GitHub
1

Dokumentation

@return-0/mcp-server

MCP (Model Context Protocol) Server für return0 – ein Werkzeug zum Debuggen von Produktionsanwendungen in Echtzeit.

Über return0

return0 ermöglicht Entwicklern das Debuggen von Node.js-Produktionsanwendungen in Echtzeit. Es erlaubt Ihnen, Ihre Anwendungen zu überwachen und Fehler zu beheben, indem Sie sich mit Live-Variablen verbinden, den Ausführungsfluss beobachten und das Laufzeitverhalten direkt in der Cursor IDE verstehen. Dies ist besonders leistungsstark für das Debuggen von Produktionsanwendungen, die mit Next.js erstellt und auf Plattformen wie Vercel bereitgestellt werden, wo traditionelle Debugging-Methoden herausfordernd sein können.

Chat Demo

Konfiguration in Cursor

Um diesen MCP-Server mit der Cursor IDE zu verwenden, müssen Sie ihn in Ihren Cursor-Einstellungen konfigurieren. Zuerst benötigen Sie Ihren return0-API-Schlüssel.

Ihren API-Schlüssel erhalten

Um Ihren return0-API-Schlüssel zu erhalten, besuchen Sie die return0-Dokumentation. Die Dokumentation führt Sie durch den Prozess der Beschaffung Ihres API-Schlüssels.

Sobald Sie Ihren API-Schlüssel haben, können Sie den MCP-Server auf eine von zwei Arten konfigurieren:

Option 1: Ein-Klick-Installation

Klicken Sie auf die Schaltfläche unten, um den return0 MCP-Server automatisch in Cursor zu installieren und zu konfigurieren:

Add to Cursor

Dadurch wird der MCP-Server automatisch konfiguriert. Hinweis: Sie müssen Ihren return0-API-Schlüssel nach der Installation zur Konfiguration hinzufügen. Siehe den Abschnitt Ihren API-Schlüssel erhalten oben für Anweisungen zur Beschaffung Ihres API-Schlüssels und den Abschnitt zur manuellen Konfiguration unten für Details zum Hinzufügen.

Option 2: Manuelle Konfiguration

Wenn Sie die manuelle Konfiguration bevorzugen, folgen Sie diesen Schritten in der Cursor IDE:

  1. Öffnen Sie die Cursor IDE
  2. Gehen Sie zu Einstellungen (oder Voreinstellungen unter macOS):
    • Klicken Sie auf das Zahnradsymbol (⚙️) in der unteren linken Ecke, oder
    • Verwenden Sie die Tastenkombination: Ctrl+, (Windows/Linux) oder Cmd+, (macOS)
  3. Geben Sie in der Einstellungssuchleiste „MCP“ oder „Model Context Protocol“ ein
  4. Klicken Sie auf MCP-Server oder navigieren Sie zum MCP-Konfigurationsabschnitt
  5. Klicken Sie auf Server hinzufügen oder die Schaltfläche +, um einen neuen MCP-Server hinzuzufügen
  6. Geben Sie die folgende Konfiguration ein:
    • Name: return0
    • Befehl: npx
    • Argumente: -y, @return-0/mcp-server
    • Umgebungsvariablen: Fügen Sie RETURN0_API_KEY mit Ihrem API-Schlüssel als Wert hinzu
  7. Klicken Sie auf Speichern oder Übernehmen, um die Konfiguration zu speichern

Die Konfiguration sollte in Ihrer mcp.json-Datei wie folgt aussehen:

{
  "mcpServers": {
    "return0": {
      "command": "npx",
      "args": ["-y", "@return-0/mcp-server"],
      "env": {
        "RETURN0_API_KEY": "your-api-key-here"
      }
    }
  }
}

Hinweis: Ersetzen Sie "your-api-key-here" durch Ihren tatsächlichen return0-API-Schlüssel. Wenn Sie noch keinen API-Schlüssel haben, lesen Sie den Abschnitt Ihren API-Schlüssel erhalten oben für Anweisungen, oder Sie können "demo" zu Testzwecken verwenden. Der MCP-Server wird automatisch über npx installiert, wenn Cursor startet.

Werkzeuge

Dieser MCP-Server stellt ein variable_extractor-Werkzeug bereit, das von MCP-kompatiblen Clients verwendet werden kann.

Werkzeug: variable_extractor

Extrahiert den Laufzeitwert, den Typ und den Zeitstempel von Variablen aus dem Produktionscode.

Eingabeschema:

{
  files: Array<{
    fileName: string;        // Full absolute path to the file
    variables: Array<{
      name: string;          // Variable name to extract
      lineNumber: number;    // Line number where variable is defined
    }>
  }>
}

Beispiel:

{
  "files": [
    {
      "fileName": "C:\\Users\\username\\project\\src\\app\\api\\route.ts",
      "variables": [
        {
          "name": "userData",
          "lineNumber": 42
        }
      ]
    }
  ]
}

Funktionsweise

  1. Der MCP-Server empfängt Anfragen zum Extrahieren von Laufzeitvariablenwerten aus dem Produktionscode
  2. Er liest die Quelldateien aus dem lokalen Dateisystem
  3. Verwendet TypeScript-AST-Analyse, um Zeilennummern für eine genaue Variablenlokalisierung zu korrigieren
  4. Verbindet sich mit der laufenden Produktionsanwendung, um Live-Variablenwerte abzurufen
  5. Gibt die korrigierten Variablenextraktionsdaten mit Echtzeit-Laufzeitwerten, Typen und Zeitstempeln zurück

Lizenz

Siehe LICENSE-Datei für Details.

Autor

return0

Links