codemcp : assistant de codage MCP pour Claude Desktop

Introduction générale

codemcp est un outil open source conçu pour Claude Conception de l'utilisateur du bureau, développée par Edward Z. Yang sur GitHub. Il fait de Claude Desktop un assistant de programmation en binôme utile. Les utilisateurs peuvent demander à Claude d'implémenter des fonctionnalités, de corriger des bugs ou de refactoriser dans leur base de code locale directement à travers le dialogue, sans avoir à copier et coller manuellement du code. codemcp support Anthropique Le service d'abonnement Claude Pro (20 $ par mois) permet d'éviter les frais d'API élevés. Il garantit des opérations d'IA sûres et contrôlées en limitant l'ensemble des outils et en imposant l'utilisation du contrôle de version Git. Les développeurs peuvent vérifier et modifier le code avec leurs IDE préférés pour une variété de scénarios de programmation.

Liste des fonctions

• Édition directe du code localModifier les fichiers d'un projet via Claude pour enregistrer automatiquement les modifications.
• Exécution des tests et formatageLes tâches de l'équipe sont les suivantes : exécuter des scripts de test et des commandes de formatage afin de maintenir la qualité du code.
• Gestion des Git CommitLes modifications sont générées par Git pour chaque changement, avec la possibilité de les visualiser et de les annuler.
• Soutien à la configuration des projetsInitialiser le projet avec un fichier de configuration pour charger les commandes personnalisées.
• Suivi du journalLes opérations d'entretien et de maintenance peuvent être effectuées à l'aide d'une clé USB ou d'une carte mémoire.

Utiliser l'aide

Processus d'installation

Pour utiliser codemcp, vous devez d'abord installer les dépendances et configurer l'environnement. Voici les étapes détaillées :

1. Installation de l'outil uv
   codemcp s'appuie sur uv pour fonctionner. Installez d'abord uv, nous vous recommandons d'utiliser le script d'installation officiel :
   • 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"
     

   Après l'installation, exécutez uv --version Vérifiez la version pour vous assurer que l'installation a réussi.

2. Configuration de Claude Desktop
   Ouvrir ou créer claude_desktop_config.json ajouter ce qui suit :

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

Après avoir sauvegardé, Claude Desktop chargera codemcp depuis GitHub via uvx.

3. Mise en place du profil du projet
   À la racine de votre dépôt Git, créez le fichier codemcp.toml Documentation. Exemple :

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

• format: Spécifie le chemin d'accès du script de formatage pour la normalisation du code.
• testSpécifiez le chemin d'accès au script de test pour l'exécution du test.
  Ces scripts doivent être écrits par vous-même pour garantir que l'environnement virtuel peut être activé et fonctionner correctement.

Comment l'utiliser

Une fois l'installation terminée, vous pouvez utiliser codemcp dans Claude Desktop. Voici la procédure exacte :

1. projet d'initialisation

Créez un nouveau projet dans Claude Desktop et saisissez-le dans les instructions du projet :

Before doing anything, first init project $PROJECT_DIR.

commandant en chef (militaire) $PROJECT_DIR Remplacez-le par le chemin de votre projet, par exemple /Users/username/myproject. Après l'initialisation, codemcp lira le fichier codemcp.toml Configuration.

2. changer les codes par le dialogue

Dans la fenêtre de chat de Claude Desktop, dites directement à Claude ce que vous voulez changer. Exemple :

• "Ajouter une fonction à main.py qui calcule la série de Fibonacci".
• "Correction d'une erreur de logique dans utils.py".
  Claude éditera le fichier via codemcp et générera automatiquement un commit Git après chaque modification. Ceci peut être fait avec git log Consulter l'historique des soumissions.

3. vérifier et gérer les modifications du code

Il est recommandé de créer une branche distincte (par ex. develop) pour exécuter codemcp avec la branche par défaut définie à mainLes commandes Git les plus courantes sont les suivantes. Les commandes suivantes sont des commandes courantes de Git :

• Voir les changements: :git diff main Affiche la différence avec la branche principale.
• Acceptation des changements: :git fetch . develop:main Fusionner les changements dans la branche principale.
  • Conservation de l'historique des soumissions : première git checkout mainune fois de plus git merge develop --no-ff.
  • Soumission de la compression : Exécuter git rebase -iSi vous n'êtes pas sûr de ce que vous voulez faire, sélectionnez squash puis exécutez fetch.
• Retrait des modifications: :git reset --keep main Revenir à l'état de la branche principale.

4. les tests de mise en œuvre et le formatage

Si vous configurez le test répondre en chantant formatVous pouvez demander à Claude d'exécuter ces commandes. Par exemple, vous pouvez demander à Claude d'exécuter ces commandes :

• "Exécutez tous les tests et vérifiez que le code fonctionne.
• "Formatage du code après l'achèvement de la mission.
  Les tests sont exécutés à mi-parcours et le formatage est effectué à la fin de la tâche.

5. traitement de la limitation du débit

Claude Pro a une limite de temps, et Claude se met en pause lorsqu'il rencontre une limite de flux. Vous pouvez utiliser ce temps :

• Vérifier le code généré.
• Planifier les prochaines tâches.
  Une fois la restriction levée, il suffit de poursuivre le dialogue.

6. consulter le journal de bord

Si vous rencontrez des problèmes, consultez la page ~/.codemcp/codemcp.log Fichier journal. Pour une journalisation plus détaillée, modifiez le fichier ~/.codemcprc: :

[logger]
verbosity = "DEBUG"

Les niveaux pris en charge sont DEBUG, INFO, WARNING, ERROR et CRITICAL.

Fonction en vedette Fonctionnement

• conception de la sécuritéCodemcp : codemcp limite la portée des outils de Claude pour éviter les abus. Toutes les modifications sont annulées via Git.
• Compatible IDELes changements de code peuvent être revus et ajustés avec n'importe quel IDE (par exemple VS Code).
• contrôle manuelDans le cas des agents non automatisés, chaque tâche doit être vérifiée et poursuivie par l'utilisateur pour s'assurer que le code va dans la bonne direction.

Avec ces étapes, vous pouvez rapidement commencer à utiliser codemcp et améliorer l'efficacité de votre programmation.