claude-code-mcp

Claude-Code-MCP-Projekt

[0.1.3] - 08.05.2025

Geändert

• Verbesserte Sicherheit durch strenge Validierung der Umgebungsvariable CLAUDE_BIN . Der Server überprüft nun vor der Verwendung Pfad, Name, Existenz und Berechtigungen der ausführbaren Datei.

Behoben

• Eine potenzielle Sicherheitslücke bei der Befehlseingabe im Zusammenhang mit der Umgebungsvariable CLAUDE_BIN wurde behoben.

Überblick

Das Claude-Code-MCP-Projekt ist ein MCP-Server für Claude Code.

Es ruft den lokal installierten Claude Code-Befehl auf und bietet die folgenden Tools: explain_code , review_code , fix_code , edit_code , test_code , simulate_command und your_own_query . Der Server wird mit Node.js und dem MCP SDK implementiert und empfängt Anfragen im JSON-Format von Clients über stdio. Intern verwendet er Base64-Kodierung, um Sonderzeichen (Zeilenumbrüche, Anführungszeichen usw.) in natürlichsprachlichem Text reibungslos zu verarbeiten, was zu verbesserter Stabilität und Flexibilität führt. Seine Hauptaufgaben sind das Empfangen von Anfragen, das Kodieren von Eingaben, das Generieren und Ausführen von Befehlen sowie das Zurückgeben von Ausführungsergebnissen im JSON-Format. Es wurde bestätigt, dass dieses Projekt in Claude Code CLI-Umgebungen (Ubuntu/WSL2 usw.) funktioniert.

💡 MCP-Host mit weniger leistungsfähigem LLM kann Claudes Leistung zähmen und nutzen💪! Mit claude-code-mcp kannst du Claude Code auch von Claude Desktop aus aufrufen!! 😇😜😎 (unbestätigt)

Funktionen

Die Hauptrollen des Servers sind:

• Anforderungsempfang: Empfangen Sie Toolanforderungen im JSON-Format von Clients (z. B. code , context , focus_areas usw.).
• Eingabeverarbeitung: Der empfangene Text in natürlicher Sprache wird intern mit Base64 kodiert.
• Werkzeugauswahl und Befehlsgenerierung: Stellen Sie basierend auf dem Werkzeugnamen in der Anforderung eine Befehlszeichenfolge für die Abfrage zusammen. Verwenden Sie dazu eine feste Vorlage oder ein freies Format ( your_own_query ).
• Befehlsausführung: Verwenden Sie child_process.spawn von Node.js, um den zusammengestellten Befehl auszuführen und das Ergebnis aus der Standardausgabe abzurufen.
• Ergebnisrückgabe: Gibt das Ausführungsergebnis im JSON-Format an den Client zurück.

Erste Schritte

Voraussetzungen

• Node.js (>= v18 empfohlen, getestet mit v22.14.0)
• npm (oder Garn)
• Claude Code-Befehl installiert und Authentifizierung abgeschlossen. https://docs.anthropic.com/en/docs/agents-and-tools/claude-code/overview

Installation und Verwendung

Es gibt mehrere Möglichkeiten claude-code-mcp zu verwenden:

1. Verwenden von npx (empfohlen für den schnellen Einsatz)

Sie können den Server ohne Installation direkt mit npx ausführen:

2. Globale Installation

Installieren Sie das Paket global:

Anschließend können Sie es als Befehl ausführen:

3. Lokale Installation (für die Entwicklung)

Klonen Sie das Repository und installieren Sie Abhängigkeiten:

Sie können das erstellte Skript dann direkt ausführen:

Konfiguration

Umgebungsvariablen:

Unabhängig von der Installationsmethode müssen Sie die Umgebungsvariablen konfigurieren. Erstellen Sie eine der folgenden Dateien:

1. Verwenden der MCP-Host-Einstellungen (empfohlen für npx ): Konfigurieren Sie Umgebungsvariablen direkt in den Einstellungen Ihres MCP-Hosts (siehe „MCP-Host-Konfiguration“ weiter unten). Dies ist der einfachste Weg bei Verwendung npx .
2. Verwenden einer .env Datei: Erstellen Sie eine .env Datei in dem Verzeichnis, in dem Sie den npx @kunihiros/claude-code-mcp ausführen.
3. Verwenden einer globalen Konfigurationsdatei: Erstellen Sie eine Datei .claude-code-mcp.env in Ihrem Home-Verzeichnis ( ~/.claude-code-mcp.env ).

Wenn Sie eine Datei ( .env oder ~/.claude-code-mcp.env ) verwenden, fügen Sie den folgenden Inhalt hinzu und passen Sie den CLAUDE_BIN Pfad an:

MCP-Hostkonfiguration (empfohlen für npx ):

Fügen Sie Folgendes zu den Einstellungen Ihrer MCP-Hostanwendung hinzu (z. B. zu den Claude-Desktop-Einstellungen). Mit dieser Methode können Sie Umgebungsvariablen direkt festlegen.

(Möglicherweise ist ein Neustart der Hostanwendung erforderlich.)

Alternative MCP-Hostkonfiguration (Globale Installation / Lokale Entwicklung):

Wenn Sie das Paket global installiert haben oder es lokal aus dem geklonten Repository ausführen und sich der Befehl claude-code-mcp im PATH Ihres Systems befindet, können Sie Folgendes verwenden:

In diesem Fall müssen Sie Umgebungsvariablen mithilfe einer .env Datei oder der globalen Datei ~/.claude-code-mcp.env konfigurieren, wie oben beschrieben.

Details zu Umgebungsvariablen

Dieser Server verwendet die folgenden Umgebungsvariablen (festgelegt über die MCP-Host env , .env oder ~/.claude-code-mcp.env ):

• CLAUDE_BIN : Gibt den Pfad zur ausführbaren Datei der Claude-CLI an. (Erforderlich) Beispiel: /home/linuxbrew/.linuxbrew/bin/claude oder C:\Users\YourUser\AppData\Local\bin\claude.exe
• LOG_LEVEL : Gibt die Protokollebene an. (Optional, standardmäßig info “). Mögliche Werte: debug , info , warn , error .

Verfügbare Tools

Der claude-code-mcp Server bietet die folgenden Tools:

• explain_code : Bietet eine detaillierte Erklärung des angegebenen Codes.
• review_code : Überprüft den angegebenen Code.
• fix_code : Behebt Fehler oder Probleme im angegebenen Code.
• edit_code : Bearbeitet den angegebenen Code basierend auf Anweisungen.
• test_code : Generiert Tests für den angegebenen Code.
• simulate_command : Simuliert die Ausführung eines bestimmten Befehls.
• your_own_query : Sendet eine benutzerdefinierte Abfrage mit Kontext.

Notiz

• Speicherort der Protokolldatei ( claude-code-mcp.log ):
  • Versucht zuerst, es im Projektstamm zu erstellen.
  • Fällt auf das Home-Verzeichnis des Benutzers zurück ( ~/.claude-code-mcp.log ).
  • Fällt schließlich auf /tmp/claude-code-mcp.log zurück.
• Die Protokollrotation ist noch nicht implementiert (achten Sie auf die Größe der Protokolldatei).
• Hauptsächlich mit Claude CLI auf Ubuntu/WSL2 getestet.

Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert – Einzelheiten siehe unten.

Haftungsausschluss

Diese Software dient ausschließlich Bildungs- und Forschungszwecken. Dieses Projekt steht in keiner offiziellen Verbindung zu Anthropic und wird auch nicht von Anthropic unterstützt. Claude ist eine Marke von Anthropic.

Das Projekt nutzt die Claude CLI als Abhängigkeit, ist aber ein unabhängiges, von der Community betriebenes Projekt. Nutzer sollten bei der Nutzung dieses Projekts die Nutzungsbedingungen von Anthropic einhalten.

Die Betreuer dieses Projekts sind nicht für den Missbrauch der Software oder Verstöße gegen die Nutzungsbedingungen von APIs oder Diensten Dritter verantwortlich.