vscode-mcp-server

VS Code MCP-Server

Eine Visual Studio Code-Erweiterung (verfügbar im Marketplace ), die es Claude und anderen MCP-Clients ermöglicht, direkt in VS Code zu programmieren! Inspiriert von Serena , nutzt aber die integrierten Funktionen von VS Code. Dies ist derzeit deutlich einfacher als Serena, funktioniert aber! Beachten Sie, dass diese Erweiterung die streambare HTTP-API und nicht die SSE-API verwendet.

Diese Erweiterung ermöglicht die Ausführung von Shell-Befehlen. Dies birgt ein potenzielles Sicherheitsrisiko. Verwenden Sie sie daher mit Vorsicht und stellen Sie sicher, dass Sie dem verwendeten MCP-Client vertrauen und der Port nicht offengelegt wird. Eine Authentifizierung wäre hilfreich, wurde aber aufgrund der sich noch in der Entwicklung befindlichen MCP-Authentifizierungsspezifikation bisher nicht implementiert.

PRs sind willkommen!

Demo-Video

https://github.com/user-attachments/assets/20b87dfb-fc39-4710-a910-b9481dde1e90

Installation

1. Installieren Sie die Erweiterung vom Marketplace oder klonen Sie dieses Repository und führen Sie npm install und npm run compile aus, um es zu erstellen.

Claude Desktop-Konfiguration

Claude Desktop kann so konfiguriert werden, dass diese Erweiterung als MCP-Server verwendet wird. Dazu sollte Ihre Datei claude_desktop_config.json wie folgt aussehen:

Ich verwende diese Erweiterung auch gerne in einem Claude-Projekt, da ich damit zusätzliche Anweisungen für Claude angeben kann. Die folgende Eingabeaufforderung funktioniert meiner Meinung nach gut:

Diese Erweiterung dient als Model Context Protocol (MCP)-Server und stellt MCP-Clients das Dateisystem und die Bearbeitungsfunktionen von VS Code zur Verfügung.

Merkmale

Die VS Code MCP Server-Erweiterung implementiert einen MCP-kompatiblen Server, der KI-Modellen und anderen MCP-Clients Folgendes ermöglicht:

• Listen Sie Dateien und Verzeichnisse in Ihrem VS Code-Arbeitsbereich auf
• Lesen Sie Dateiinhalte mit Kodierungsunterstützung und Größenbeschränkungen
• Suchen Sie in Ihrem Arbeitsbereich nach Symbolen
• Erhalten Sie Symboldefinitionen und Hover-Informationen nach Zeilen- und Symbolnamen
• Erstellen Sie neue Dateien mit der WorkspaceEdit-API von VS Code
• Zeilenersetzungen in Dateien vornehmen
• Suchen Sie in Ihrem Arbeitsbereich nach Diagnosen (Fehlern und Warnungen).
• Ausführen von Shell-Befehlen im integrierten Terminal mit Shell-Integration
• Schalten Sie den Server über ein Statusleistenelement ein und aus

Diese Erweiterung ermöglicht KI-Assistenten und anderen Tools die Interaktion mit Ihrem VS Code-Arbeitsbereich über das standardisierte MCP-Protokoll.

Wie es funktioniert

Die Erweiterung erstellt einen MCP-Server, der:

1. Läuft lokal auf einem konfigurierbaren Port (wenn aktiviert)
2. Verarbeitet MCP-Protokollanforderungen über HTTP
3. Stellt die Funktionalität von VS Code als MCP-Tools zur Verfügung
4. Bietet eine Statusleistenanzeige, die den Serverstatus anzeigt und durch Anklicken den Server ein- und ausschaltet

Unterstützte MCP-Tools

Datei-Tools

• list_files_code : Listet Dateien und Verzeichnisse in Ihrem Arbeitsbereich auf
  • Parameter:
    • path : Der Pfad, aus dem die Dateien aufgelistet werden sollen
    • recursive (optional): Ob Dateien rekursiv aufgelistet werden sollen
• read_file_code : Liest Dateiinhalte
  • Parameter:
    • path : Der Pfad zur zu lesenden Datei
    • encoding (optional): Dateikodierung (Standard: UTF-8)
    • maxCharacters (optional): Maximale Zeichenanzahl (Standard: 100.000)

Bearbeitungswerkzeuge

• create_file_code : Erstellt eine neue Datei mit der WorkspaceEdit-API von VS Code
  • Parameter:
    • path : Der Pfad zur zu erstellenden Datei
    • content : Der Inhalt, der in die Datei geschrieben werden soll
    • overwrite (optional): Ob die Datei überschrieben werden soll, wenn sie existiert (Standard: false)
    • ignoreIfExists (optional): Ob ignoriert werden soll, wenn die Datei existiert (Standard: false)
• replace_lines_code : Ersetzt bestimmte Zeilen in einer Datei
  • Parameter:
    • path : Der Pfad zur zu ändernden Datei
    • startLine : Die Startzeilennummer (basierend auf 1, einschließlich)
    • endLine : Die Endzeilennummer (basierend auf 1, einschließlich)
    • content : Der neue Inhalt, durch den die Zeilen ersetzt werden sollen
    • originalCode : Der Originalcode zur Validierung

Diagnosetools

• get_diagnostics_code : Überprüft Ihren Arbeitsbereich auf Warnungen und Fehler
  • Parameter:
    • path (optional): Zu prüfender Dateipfad (falls nicht angegeben, wird der gesamte Arbeitsbereich geprüft)
    • severities (optional): Array der einzuschließenden Schweregrade (0=Fehler, 1=Warnung, 2=Information, 3=Hinweis). Standard: [0, 1]
    • format (optional): Ausgabeformat ('Text' oder 'JSON'). Standard: 'Text'
    • includeSource (optional): Gibt an, ob die Diagnosequelle eingeschlossen werden soll. Standard: true

  Dieses Tool ist besonders nützlich für:

  • Codequalitätsprüfungen vor dem Festschreiben von Änderungen
  • Durch die Überprüfung der Fixes wurden alle gemeldeten Probleme behoben
  • Identifizieren von Problemen in bestimmten Dateien oder im gesamten Arbeitsbereich

Symbolwerkzeuge

• search_symbols_code : Sucht nach Symbolen im gesamten Arbeitsbereich
  • Parameter:
    • query : Die Suchanfrage für Symbolnamen
    • maxResults (optional): Maximale Anzahl der zurückzugebenden Ergebnisse (Standard: 10)

  Dieses Tool ist nützlich für:

  • Suchen von Definitionen von Symbolen (Funktionen, Klassen, Variablen usw.) in der gesamten Codebasis
  • Erkundung der Projektstruktur und -organisation
  • Auffinden bestimmter Elemente anhand des Namens
• get_symbol_definition_code : Ruft Definitionsinformationen für ein Symbol in einer Datei ab
  • Parameter:
    • path : Der Pfad zur Datei, die das Symbol enthält
    • line : Die Zeilennummer des Symbols
    • symbol : Der Symbolname, nach dem in der angegebenen Zeile gesucht werden soll

  Dieses Tool bietet:

  • Typinformationen, Dokumentation und Quelldetails für Symbole
  • Codekontext, der die Zeile zeigt, in der das Symbol erscheint
  • Informationen zum Symbolbereich

  Es ist besonders nützlich für:

  • Verstehen, was ein Symbol darstellt, ohne wegzunavigieren
  • Überprüfen von Funktionssignaturen, Typdefinitionen oder Dokumentation
  • Kurzreferenz für APIs oder Bibliotheksfunktionen

Shell-Tools

• execute_shell_command_code : Führt einen Shell-Befehl im integrierten VS Code-Terminal mit Shell-Integration aus
  • Parameter:
    • command : Der auszuführende Shell-Befehl
    • cwd (optional): Optionales Arbeitsverzeichnis für den Befehl (Standard: „.“)

  Dieses Tool ist nützlich für:

  • Ausführen von CLI-Befehlen und Build-Vorgängen
  • Ausführen von Git-Befehlen
  • Ausführen von Shell-Operationen, die einen Terminalzugriff erfordern
  • Abrufen der Befehlsausgabe zur Analyse und Weiterverarbeitung

Vorbehalte/TODO

Derzeit wird nur ein Arbeitsbereich unterstützt. Die Erweiterung funktioniert außerdem nur lokal, um zu verhindern, dass Ihre VS Code-Instanz einem Netzwerk ausgesetzt wird, mit dem Sie möglicherweise verbunden sind.

Erweiterungseinstellungen

Diese Erweiterung bietet die folgenden Einstellungen:

• vscode-mcp-server.port : Die Portnummer für den MCP-Server (Standard: 3000)

Verwendung mit MCP-Clients

Um MCP-Clients mit diesem Server zu verbinden, konfigurieren Sie sie für die Verwendung von:

Denken Sie daran, dass Sie zuerst den Server aktivieren müssen, indem Sie auf das Statusleistenelement klicken!

Beitragen

Beiträge sind willkommen! Senden Sie gerne Probleme oder Pull Requests.

Lizenz

MIT