codemcp: Kodierassistent MCP für Claude Desktop

Allgemeine Einführung

codemcp ist ein Open-Source-Tool, das für Claude Desktop-Benutzerdesign, entwickelt von Edward Z. Yang auf GitHub. Es macht Claude Desktop zu einem nützlichen Assistenten für die Paarprogrammierung. Benutzer können Claude bitten, Funktionen zu implementieren, Fehler zu beheben oder ihre lokale Codebasis direkt im Dialog zu überarbeiten, ohne Code manuell kopieren und einfügen zu müssen. codemcp-Unterstützung Anthropisch Der Claude Pro-Abonnementdienst (20 $ pro Monat) vermeidet hohe API-Gebühren. Er gewährleistet sichere und kontrollierte KI-Operationen, indem er das Toolset einschränkt und die Verwendung der Git-Versionskontrolle erzwingt. Entwickler können den Code mit ihren bevorzugten IDEs für eine Vielzahl von Programmierszenarien überprüfen und optimieren.

Funktionsliste

• Direkte Bearbeitung des lokalen CodesÄndern Sie Projektdateien über Claude, um die Änderungen automatisch zu speichern.
• Durchführung von Tests und FormatierungAusführen von Testskripten und Formatierungsbefehlen zur Aufrechterhaltung der Codequalität.
• Git-Commit-VerwaltungGenerieren von Git-Commits für jede Änderung, mit Unterstützung für die Anzeige und das Rollback.
• Unterstützung bei der ProjektkonfigurationInitialisieren Sie das Projekt mit einer Konfigurationsdatei, um benutzerdefinierte Befehle zu laden.
• Log-VerfolgungAufzeichnung von Betriebsdetails zur einfachen Fehlersuche.

Hilfe verwenden

Ablauf der Installation

Um codemcp zu verwenden, müssen Sie zunächst die Abhängigkeiten installieren und die Umgebung konfigurieren. Im Folgenden sind die einzelnen Schritte aufgeführt:

1. Installieren des uv-Tools
   codemcp benötigt uv, um zu laufen. Installieren Sie zunächst uv. Wir empfehlen die Verwendung des offiziellen Installationsskripts:
   • Linux/MacOS:

     curl -LsSf https://astral.sh/uv/install.sh | sh
     

   • Windows (PowerShell):

     powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
     

   Nach der Installation führen Sie uv --version Überprüfen Sie die Version, um sicherzustellen, dass die Installation erfolgreich war.

2. Claude Desktop konfigurieren
   Öffnen oder erstellen claude_desktop_config.json fügen Sie Folgendes hinzu:

{
"mcpServer": {
"codemcp": {
"Befehl": "uvx",
"args": [
"--from".
"git+https://github.com/ezyang/codemcp@prod",
"codemcp"
]
}
}
}

Nach dem Speichern lädt Claude Desktop codemcp von GitHub über uvx.

3. Einrichten des Projektprofils
   Erstellen Sie im Stammverzeichnis Ihres Git-Repositorys die Datei codemcp.toml Dokumentation. Beispiel:

format = [". /run_format.sh"]
test = [". /run_test.sh"]

• FormatFormatierungsskript: Gibt den Pfad des Formatierungsskripts für die Code-Normalisierung an.
• TestTestskriptpfad: Geben Sie den Testskriptpfad für die Durchführung des Tests an.
  Diese Skripte müssen von Ihnen selbst geschrieben werden, um sicherzustellen, dass die virtuelle Umgebung aktiviert und korrekt ausgeführt werden kann.

Wie zu verwenden

Nachdem die Installation abgeschlossen ist, können Sie codemcp in Claude Desktop bedienen:

1. das Initialisierungsprojekt

Erstellen Sie ein neues Projekt in Claude Desktop und geben Sie es in den Projektanweisungen ein:

Bevor Sie etwas tun, starten Sie zunächst das Projekt $PROJECT_DIR.

Oberbefehlshaber (Militär) $PROJECT_DIR Ersetzen Sie ihn durch Ihren Projektpfad, z. B. /Benutzer/Benutzername/meinProjekt. Nach der Initialisierung liest codemcp die codemcp.toml Konfiguration.

2. die Änderung von Codes durch Dialog

Sagen Sie Claude im Chatfenster von Claude Desktop direkt, was Sie ändern möchten. Beispiel:

• "Füge eine Funktion zu main.py hinzu, die die Fibonacci-Reihe berechnet."
• "Logikfehler in utils.py beheben".
  Claude wird die Datei über codemcp bearbeiten und nach jeder Änderung automatisch ein Git-Commit erzeugen. Dies kann mit der Option Idiotenprotokoll Einreichungshistorie anzeigen.

3. die Prüfung und Verwaltung von Codeänderungen

Es wird empfohlen, dass ein separater Zweig (z.B. entwickeln.), um codemcp mit dem Standardzweig auszuführen, der auf HauptNachfolgend finden Sie die üblichen Git-Befehle. Nachfolgend sind gängige Git-Befehle aufgeführt:

• Änderungen anzeigen::git diff main Zeigt den Unterschied zum Master-Zweig an.
• Akzeptanz von Änderungen::git fetch . entwickeln:main Führen Sie die Änderungen in den Master-Zweig ein.
  • Aufbewahrung der Einreichungshistorie: erste git checkout mainwieder einmal git merge develop --no-ff.
  • Kompression Einreichung: Ausführen git rebase -iWenn Sie sich nicht sicher sind, was Sie tun wollen, wählen Sie "squash" und führen Sie dann "fetch" aus.
• Rücknahme von Änderungen::git reset --keep main Zum Status des Masterzweigs zurückkehren.

4. die Prüfung der Umsetzung und die Formatierung

Wenn Sie die Test im Gesang antworten FormatSie können Claude bitten, diese Befehle auszuführen. Zum Beispiel:

• "Führen Sie alle Tests durch und prüfen Sie, ob der Code funktioniert."
• "Formatierung des Codes nach Abschluss der Mission".
  Die Tests werden in der Mitte der Aufgabe durchgeführt und die Formatierung erfolgt am Ende der Aufgabe.

5. die Handhabung der Durchflussbegrenzung

Claude Pro hat ein Zeitlimit, und Claude hält an, wenn es auf ein Stream-Limit stößt. Sie können diese Zeit nutzen:

• Überprüfen Sie den generierten Code.
• Planung der nächsten Aufgaben.
  Sobald die Beschränkung aufgehoben ist, setzen Sie den Dialog einfach fort.

6. die Einsicht in das Logbuch

Wenn Sie Probleme haben, sehen Sie sich die ~/.codemcp/codemcp.log Protokolldatei. Für eine ausführlichere Protokollierung bearbeiten Sie die Datei ~/.codemcprc::

[logger]
Ausführlichkeit = "DEBUG"

Die unterstützten Stufen sind DEBUG, INFO, WARNING, ERROR und CRITICAL.

Featured Function Bedienung

• Sicherheitskonzeptcodemcp: Der Anwendungsbereich von Claudes Werkzeugen ist begrenzt, um Missbrauch zu vermeiden. Alle Änderungen werden über Git rückgängig gemacht.
• IDE-kompatibelCodeänderungen können mit jeder IDE (z.B. VS Code) überprüft und angepasst werden.
• manuelle SteuerungNicht-automatisierte Agenten: Jede Aufgabe muss vom Benutzer überprüft und fortgesetzt werden, um sicherzustellen, dass der Code in die richtige Richtung geht.

Mit diesen Schritten können Sie schnell mit codemcp arbeiten und Ihre Programmiereffizienz verbessern.