Aider MCP Server

Aider MCP-Server – experimentell

Modellkontextprotokollserver zum Auslagern von KI-Codierungsarbeiten an Aider, wodurch die Entwicklungseffizienz und -flexibilität verbessert wird.

Überblick

Dieser Server ermöglicht es Claude Code, KI-Programmieraufgaben an Aider, den besten Open-Source-KI-Programmierassistenten, auszulagern. Durch die Delegierung bestimmter Programmieraufgaben an Aider können wir Kosten senken, die Kontrolle über unser Programmiermodell gewinnen und Claude Code orchestrierter einsetzen, um Code zu überprüfen und zu überarbeiten.

Aufstellen

0. Klonen Sie das Repository:

1. Installieren Sie Abhängigkeiten:

2. Erstellen Sie Ihre Umgebungsdatei:

3. Konfigurieren Sie Ihre API-Schlüssel in der .env Datei (oder verwenden Sie den Abschnitt „env“ von mcpServers), um den API-Schlüssel zu haben, der für das Modell erforderlich ist, das Sie in aider verwenden möchten:

4. Kopieren Sie die .mcp.json , füllen Sie sie im Stammverzeichnis Ihres Projekts aus und aktualisieren Sie --directory , sodass es auf das Stammverzeichnis dieses Projekts verweist, und --current-working-dir sodass es auf das Stammverzeichnis Ihres Projekts verweist.

Testen

Tests ausgeführt mit gemini-2.5-pro-exp-03-25

So führen Sie alle Tests aus:

So führen Sie bestimmte Tests durch:

Hinweis: Für die KI-Codierungstests ist ein gültiger API-Schlüssel für das Gemini-Modell erforderlich. Stellen Sie sicher, dass Sie ihn vor dem Ausführen der Tests in Ihrer .env Datei festlegen.

Fügen Sie diesen MCP-Server zu Claude Code hinzu

Hinzufügen mit gemini-2.5-pro-exp-03-25

Hinzufügen mit gemini-2.5-pro-preview-03-25

Hinzufügen mit quasar-alpha

Hinzufügen mit llama4-maverick-instruct-basic

Verwendung

Dieser MCP-Server bietet die folgenden Funktionen:

1. Übertragen Sie KI-Codierungsaufgaben auf Aider :
   • Nimmt eine Eingabeaufforderung und Dateipfade entgegen
   • Verwendet Aider, um die gewünschten Änderungen umzusetzen
   • Gibt Erfolg oder Misserfolg zurück
2. Liste der verfügbaren Modelle :
   • Stellt eine Liste von Modellen bereit, die einer Teilzeichenfolge entsprechen
   • Nützlich zum Entdecken unterstützter Modelle

Verfügbare Tools

Dieser MCP-Server stellt die folgenden Tools bereit:

1. aider_ai_code

Mit diesem Tool können Sie Aider ausführen, um KI-Codierungsaufgaben basierend auf einer bereitgestellten Eingabeaufforderung und angegebenen Dateien durchzuführen.

Parameter:

• ai_coding_prompt (Zeichenfolge, erforderlich): Die Anweisung in natürlicher Sprache für die KI-Codierungsaufgabe.
• relative_editable_files (Liste von Zeichenfolgen, erforderlich): Eine Liste von Dateipfaden (relativ zum current_working_dir ), die Aider ändern darf. Falls eine Datei nicht existiert, wird sie erstellt.
• relative_readonly_files (Liste von Zeichenfolgen, optional): Eine Liste von Dateipfaden (relativ zum current_working_dir ), die Aider zum Kontext lesen, aber nicht ändern kann. Standardmäßig ist die Liste leer [] .
• model (Zeichenfolge, optional): Das primäre KI-Modell, das Aider zur Codegenerierung verwenden soll. Standardmäßig ist der Wert "gemini/gemini-2.5-pro-exp-03-25" eingestellt. Mit dem Tool list_models können Sie weitere verfügbare Modelle finden.
• editor_model (Zeichenfolge, optional): Das KI-Modell, das Aider zum Bearbeiten/Verfeinern von Code verwenden soll, insbesondere im Architektenmodus. Falls nicht angegeben, kann je nach Aiders interner Logik das primäre model verwendet werden. Standardmäßig „ None .

Beispielverwendung (innerhalb einer MCP-Anfrage):

Claude Code-Eingabeaufforderung:

Ergebnis:

Widerrufsfolgen:

• Ein einfaches Diktat: {Erfolg, Unterschied}
  • success : Boolesch – Ob der Vorgang erfolgreich war.
  • diff : Zeichenfolge – Der Unterschied der an der Datei vorgenommenen Änderungen.

2. list_models

Dieses Tool listet verfügbare, von Aider unterstützte KI-Modelle auf, die mit einer bestimmten Teilzeichenfolge übereinstimmen.

Parameter:

• substring (Zeichenfolge, erforderlich): Die Teilzeichenfolge, nach der in den Namen der verfügbaren Modelle gesucht werden soll.

Beispielverwendung (innerhalb einer MCP-Anfrage):

Claude Code-Eingabeaufforderung:

Ergebnis:

Widerrufsfolgen:

• Eine Liste von Modellnamen, die mit der angegebenen Teilzeichenfolge übereinstimmen. Beispiel: ["gemini/gemini-1.5-flash", "gemini/gemini-1.5-pro", "gemini/gemini-pro"]

Architektur

Der Server ist wie folgt aufgebaut:

• Serverebene : Behandelt die MCP-Protokollkommunikation
• Atomschicht : Einzelne, reine Funktionskomponenten
  • Tools : Spezifische Funktionen (KI-Codierung, Auflistung von Modellen)
  • Utils : Konstanten und Hilfsfunktionen
  • Datentypen : Typdefinitionen mit Pydantic

Alle Komponenten werden gründlich auf Zuverlässigkeit getestet.

Codebasisstruktur

Das Projekt ist in die folgenden Hauptverzeichnisse und Dateien unterteilt:

• src/aider_mcp_server : Enthält den Hauptanwendungscode.
  • atoms : Enthält die grundlegenden Bausteine. Diese sind als reine Funktionen oder einfache Klassen mit minimalen Abhängigkeiten konzipiert.
    • tools : Jede Datei hier implementiert die Kernlogik für ein bestimmtes MCP-Tool ( aider_ai_code , list_models ).
    • utils.py : Enthält gemeinsame Konstanten wie Standardmodellnamen.
    • data_types.py : Definiert Pydantic-Modelle für Anforderungs-/Antwortstrukturen und stellt so die Datenvalidierung sicher.
    • logging.py : Richtet ein konsistentes Protokollierungsformat für die Konsolen- und Dateiausgabe ein.
  • server.py : Orchestriert den MCP-Server. Es initialisiert den Server, registriert die im Verzeichnis atoms/tools definierten Tools, verarbeitet eingehende Anfragen, leitet sie an die entsprechende Tool-Logik weiter und sendet Antworten gemäß dem MCP-Protokoll zurück.
  • __main__.py : Stellt den Einstiegspunkt der Befehlszeilenschnittstelle ( aider-mcp-server ) bereit, analysiert Argumente wie --editor-model und startet den in server.py definierten Server.
  • tests : Enthält Tests, die die Struktur des src Verzeichnisses widerspiegeln und sicherstellen, dass jede Komponente (insbesondere Atome) wie erwartet funktioniert.