Claude Code MCP Server

Claude Code MCP Server

Ein MCP-Server (Model Context Protocol), der die Ausführung von Claude Code im One-Shot-Modus mit automatisch umgangenen Berechtigungen ermöglicht.

Ist Ihnen aufgefallen, dass Cursor manchmal mit komplexen, mehrstufigen Bearbeitungen oder Operationen zu kämpfen hat? Dieser Server mit seinem leistungsstarken, einheitlichen Tool claude_code macht Claude zu einem direkteren und leistungsfähigeren Agenten für Ihre Programmieraufgaben.

Überblick

Dieser MCP-Server bietet ein Tool, das LLMs zur Interaktion mit Claude Code nutzen können. In Kombination mit Claude Desktop oder anderen MCP-Clients ermöglicht er LLMs Folgendes:

• Führen Sie Claude Code mit umgangenen Berechtigungen aus (mit --dangerously-skip-permissions )
• Führen Sie Claude Code mit jeder Eingabeaufforderung ohne Berechtigungsunterbrechungen aus
• Greifen Sie direkt auf die Dateibearbeitungsfunktionen zu
• Bestimmte Tools standardmäßig aktivieren

Vorteile

• Claude/Windsurf haben oft Probleme beim Bearbeiten von Dateien. Claude Code kann das besser und schneller.
• Mehrere Befehle können in die Warteschlange gestellt werden, anstatt sie direkt auszuführen. Dies spart Kontextspeicher, sodass wichtige Dinge länger gespeichert werden und weniger Komprimierungen stattfinden.
• Dateioperationen, Git oder andere Operationen benötigen keine teuren Modelle. Claude Code ist mit Antropic Max sehr kostengünstig. Sie können Gemini oder o3 im Max-Modus nutzen und Kosten sparen, indem Sie Aufgaben auf günstigere Modelle auslagern.
• Claude hat einen breiteren Systemzugriff und kann Dinge tun, die Cursor/Windsurf nicht können (oder glauben, dass sie es nicht können). Wenn sie also nicht weiterkommen, sagen Sie ihnen einfach „Verwende den Claude-Code“, und normalerweise werden sie wieder frei.
• Agenten in Agentenregeln.

Voraussetzungen

• Node.js v20 oder höher (Verwenden Sie fnm oder nvm zur Installation)
• Claude CLI lokal installiert (ausführen und /doctor aufrufen) und -dangerously-skip-permissions akzeptiert.

Konfiguration

Umgebungsvariablen

• CLAUDE_CLI_NAME : Überschreibt den Namen der Claude-CLI-Binärdatei oder gibt einen absoluten Pfad an (Standard: claude ). Dies ermöglicht die Verwendung einer benutzerdefinierten Claude-CLI-Binärdatei. Dies ist nützlich für:
  • Verwenden benutzerdefinierter Claude CLI-Wrapper
  • Testen mit simulierten Binärdateien
  • Mehrere Claude CLI-Versionen nebeneinander ausführen

  Unterstützte Formate:

  • Einfacher Name: CLAUDE_CLI_NAME=claude-custom oder CLAUDE_CLI_NAME=claude-v2
  • Absoluter Pfad: CLAUDE_CLI_NAME=/path/to/custom/claude

  Relative Pfade (z. B. ./claude oder ../claude ) sind nicht zulässig und führen zu einem Fehler.

  Wenn ein einfacher Name festgelegt ist, sucht der Server nach der angegebenen Binärdatei in:

  1. Der Systempfad (anstelle des Standardbefehls claude )

  Hinweis: Der lokale Benutzerinstallationspfad ( ~/.claude/local/claude ) wird weiterhin überprüft, jedoch nur für die Standard-Binärdatei claude .

• MCP_CLAUDE_DEBUG : Debug-Protokollierung aktivieren (auf true setzen für ausführliche Ausgabe)

Installation und Verwendung

Die empfohlene Verwendungsmethode für diesen Server ist die Installation mithilfe von npx .

Um einen benutzerdefinierten Claude CLI-Binärnamen zu verwenden, können Sie die Umgebungsvariable angeben:

Wichtig bei der Ersteinrichtung: Akzeptieren von Berechtigungen

Bevor der MCP-Server das Tool claude_code erfolgreich verwenden kann, müssen Sie die Claude CLI zunächst einmal manuell mit dem Flag --dangerously-skip-permissions ausführen, sich anmelden und die Bedingungen akzeptieren.

Dies ist eine einmalige Anforderung der Claude CLI.

Befolgen Sie die Anweisungen zum Akzeptieren. Sobald dies erledigt ist, kann der MCP-Server das Flag nicht-interaktiv verwenden.

macOS fragt beim ersten Ausführen des Tools möglicherweise nach allen möglichen Ordnerberechtigungen. Der erste Durchlauf schlägt dann fehl. Nachfolgende Durchläufe funktionieren jedoch.

Herstellen einer Verbindung zu Ihrem MCP-Client

Nachdem Sie den Server eingerichtet haben, müssen Sie Ihren MCP-Client konfigurieren (wie Cursor oder andere, die mcp.json oder mcp_config.json verwenden).

MCP-Konfigurationsdatei

Die Konfiguration erfolgt typischerweise in einer JSON-Datei. Name und Speicherort können je nach Client variieren.

Cursor

Der Cursor verwendet mcp.json .

• macOS: ~/.cursor/mcp.json
• Windows: %APPDATA%\\Cursor\\mcp.json
• Linux: ~/.config/cursor/mcp.json

Windsurf

Windsurf-Benutzer verwenden mcp_config.json

• macOS: ~/.codeium/windsurf/mcp_config.json
• Windows: %APPDATA%\\Codeium\\windsurf\\mcp_config.json
• Linux: ~/.config/.codeium/windsurf/mcp_config.json

(Hinweis: In einigen gemischten Setups greifen diese Clients möglicherweise auf den Cursor-Pfad ~/.cursor/mcp.json zurück, wenn auch Cursor installiert ist. Priorisieren Sie die Codeium-spezifischen Pfade, wenn Sie die Codeium-Erweiterung verwenden.)

Erstellen Sie diese Datei, falls sie nicht vorhanden ist. Fügen Sie die Konfiguration für claude_code hinzu oder aktualisieren Sie sie:

Mitgelieferte Werkzeuge

Dieser Server stellt ein primäres Tool bereit:

claude_code

Führt eine Eingabeaufforderung direkt mithilfe der Claude Code CLI mit --dangerously-skip-permissions aus.

Argumente:

• prompt (Zeichenfolge, erforderlich): Die an Claude Code zu sendende Eingabeaufforderung.
• options (Objekt, optional):
  • tools (Array von Zeichenfolgen, optional): Zu aktivierende spezifische Claude-Tools (z. B. Bash , Read , Write ). Allgemeine Tools sind standardmäßig aktiviert.

Beispiel einer MCP-Anforderung:

Beispiele

Hier sind einige visuelle Beispiele des Servers in Aktion:

Beheben des ESLint-Setups

Hier ist ein Beispiel für die Verwendung des Claude Code MCP-Tools zum interaktiven Reparieren eines ESLint-Setups durch Löschen alter Konfigurationsdateien und Erstellen einer neuen:

Beispiel zum Auflisten von Dateien

Hier ist ein Beispiel für das Claude Code-Tool, das Dateien in einem Verzeichnis auflistet:

Wichtige Anwendungsfälle

Dieser Server erschließt mit seinem einheitlichen claude_code Tool eine Vielzahl leistungsstarker Funktionen, indem er Ihrer KI direkten Zugriff auf die Claude Code-CLI gewährt. Hier sind einige Beispiele dafür, was Sie erreichen können:

1. Codegenerierung, -analyse und -refactoring:
   • "Generate a Python script to parse CSV data and output JSON."
   • "Analyze my_script.py for potential bugs and suggest improvements."
2. Dateisystemoperationen (Erstellen, Lesen, Bearbeiten, Verwalten):
   • Dateien erstellen: "Your work folder is /Users/steipete/my_project\n\nCreate a new file named 'config.yml' in the 'app/settings' directory with the following content:\nport: 8080\ndatabase: main_db"
   • Dateien bearbeiten: "Your work folder is /Users/steipete/my_project\n\nEdit file 'public/css/style.css': Add a new CSS rule at the end to make all 'h2' elements have a 'color: navy'."
   • Verschieben/Kopieren/Löschen: "Your work folder is /Users/steipete/my_project\n\nMove the file 'report.docx' from the 'drafts' folder to the 'final_reports' folder and rename it to 'Q1_Report_Final.docx'."
3. Versionskontrolle (Git):
   • "Your work folder is /Users/steipete/my_project\n\n1. Stage the file 'src/main.java'.\n2. Commit the changes with the message 'feat: Implement user authentication'.\n3. Push the commit to the 'develop' branch on origin."
4. Ausführen von Terminalbefehlen:
   • "Your work folder is /Users/steipete/my_project/frontend\n\nRun the command 'npm run build'."
   • "Open the URL https://developer.mozilla.org in my default web browser."
5. Websuche und Zusammenfassung:
   • "Search the web for 'benefits of server-side rendering' and provide a concise summary."
6. Komplexe mehrstufige Arbeitsabläufe:
   • Automatisieren Sie Versionssprünge, aktualisieren Sie Änderungsprotokolle und kennzeichnen Sie Releases: "Your work folder is /Users/steipete/my_project\n\nFollow these steps: 1. Update the version in package.json to 2.5.0. 2. Add a new section to CHANGELOG.md for version 2.5.0 with the heading '### Added' and list 'New feature X'. 3. Stage package.json and CHANGELOG.md. 4. Commit with message 'release: version 2.5.0'. 5. Push the commit. 6. Create and push a git tag v2.5.0."
7. Reparieren von Dateien mit Syntaxfehlern:
   • "Your work folder is /path/to/project\n\nThe file 'src/utils/parser.js' has syntax errors after a recent complex edit that broke its structure. Please analyze it, identify the syntax errors, and correct the file to make it valid JavaScript again, ensuring the original logic is preserved as much as possible."
8. Interaktion mit GitHub (z. B. Erstellen einer Pull-Anfrage):
   • "Your work folder is /Users/steipete/my_project\n\nCreate a GitHub Pull Request in the repository 'owner/repo' from the 'feature-branch' to the 'main' branch. Title: 'feat: Implement new login flow'. Body: 'This PR adds a new and improved login experience for users.'"
9. Interaktion mit GitHub (z. B. Überprüfen des PR-CI-Status):
   • "Your work folder is /Users/steipete/my_project\n\nCheck the status of CI checks for Pull Request #42 in the GitHub repository 'owner/repo'. Report if they have passed, failed, or are still running."

Korrigieren des GitHub Actions-Workflows

Komplexe mehrstufige Vorgänge

Dieses Beispiel veranschaulicht, wie claude_code eine komplexere, mehrstufige Aufgabe verarbeitet, z. B. die Vorbereitung einer Version durch Erstellen eines Zweigs, Aktualisieren mehrerer Dateien ( package.json , CHANGELOG.md ), Übernehmen von Änderungen und Initiieren einer Pull-Anfrage – alles in einem einzigen, zusammenhängenden Vorgang.

WICHTIG: Denken Sie daran, in Ihren Eingabeaufforderungen für Dateisystem- oder Git-Operationen den Kontext des aktuellen Arbeitsverzeichnisses (CWD) anzugeben (z. B. "Your work folder is /path/to/project\n\n...your command..." ).

Fehlerbehebung

• „Befehl nicht gefunden“ (claude-code-mcp): Stellen Sie bei globaler Installation sicher, dass sich das globale Bin-Verzeichnis von npm im Pfad Ihres Systems befindet. Stellen Sie bei Verwendung von npx sicher, dass npx selbst funktioniert.
• „Befehl nicht gefunden“ (claude oder ~/.claude/local/claude): Stellen Sie sicher, dass die Claude-CLI korrekt installiert ist. Führen Sie claude/doctor aus oder lesen Sie die Dokumentation.
• Berechtigungsprobleme: Stellen Sie sicher, dass Sie den Schritt „Wichtige Ersteinrichtung“ ausgeführt haben.
• JSON-Fehler vom Server: Wenn MCP_CLAUDE_DEBUG auf true gesetzt ist, können Fehlermeldungen oder Protokolle die JSON-Analyse von MCP beeinträchtigen. Für den normalen Betrieb auf false setzen.
• ESM-/Importfehler: Stellen Sie sicher, dass Sie Node.js v20 oder höher verwenden.

Für Entwickler: Lokale Einrichtung und Mitwirkung

Wenn Sie diesen Server weiterentwickeln oder zu ihm beitragen möchten oder ihn zu Testzwecken aus einem geklonten Repository ausführen möchten, lesen Sie bitte unseren Einrichtungsleitfaden für die lokale Installation und Entwicklung .

Testen

Das Projekt umfasst umfassende Test-Suiten:

Eine ausführliche Testdokumentation finden Sie in unserem E2E-Testhandbuch .

Konfiguration über Umgebungsvariablen

Das Verhalten des Servers kann mithilfe dieser Umgebungsvariablen angepasst werden:

• CLAUDE_CLI_PATH : Absoluter Pfad zur ausführbaren Datei Claude CLI.
  • Standard: Überprüft ~/.claude/local/claude und greift dann auf claude zurück (wird im PATH erwartet).
• MCP_CLAUDE_DEBUG : Auf true setzen, um eine ausführliche Debug-Protokollierung von diesem MCP-Server zu erhalten. Standard: false .

Diese können in Ihrer Shell-Umgebung oder innerhalb des env Ihrer mcp.json -Serverkonfiguration festgelegt werden (obwohl der env in mcp.json -Beispielen der Einfachheit halber entfernt wurde, ist dies immer noch eine gültige Möglichkeit, sie bei Bedarf für den Serverprozess festzulegen).

Beitragen

Beiträge sind willkommen! Weitere Informationen zur Einrichtung Ihrer Umgebung finden Sie im Handbuch zur lokalen Installation und Entwicklung .

Senden Sie Probleme und Pull-Anfragen an das GitHub-Repository .

Lizenz

MIT