@aidemd-mcp/server

Ein MCP-Server, der intent-gesteuerte Entwicklung in jede KI-gestützte IDE bringt. Verwalten Sie .aide-Spezifikationsdateien, die direkt neben Ihrem Code liegen – der Domänenkontext, auf dessen Basis Architekten planen, Implementierer entwickeln und QA validiert.

Funktionen

• Projektweite Spezifikationserkennung mit einem Baum zur progressiven Offenlegung, der Absicht, Recherche und QA-Spezifikationen auf jeder Ebene Ihrer Codebasis sichtbar macht.

• Ein-Befehls-Projekt-Bootstrap via aide_init – integriert Methodik-Dokumente, Pipeline-Befehle und diesen MCP-Server in einem einzigen geführten Ablauf in Ihr Projekt.

• Automatische Durchsetzung von Namenskonventionen – aide_scaffold handhabt die .aide / intent.aide-Umbenennungsregeln, sodass Sie niemals widersprüchliche Spezifikationen erstellen.

• Gesundheitsprüfung via aide_validate – erkennt verwaiste Spezifikationen, fehlende Beschreibungen, defekte Links und Namenskonflikte, bevor sie zu Abweichungen führen.

• Erkennung von Upgrade-Abweichungen via aide_upgrade – vergleicht die AIDE-Methodik-Artefakte Ihres Projekts mit kanonischen Versionen und schreibt Updates pro Kategorie.

Installation

Schnellstart (Claude Code)

Der schnellste Weg ist ein einzelner npx-Befehl, der alles automatisch einrichtet:

npx @aidemd-mcp/server@latest init

Dieser Befehl:

• Fügt den AIDE MCP-Server-Eintrag in .mcp.json ein (erstellt die Datei oder überspringt den Eintrag, falls bereits vorhanden).

• Schreibt den /aide:init-Slash-Befehl nach .claude/commands/aide/init.md (überspringt, falls vorhanden).

• Schreibt den aide-tree-Launcher nach .aide/bin/aide-tree.mjs (überspringt, falls vorhanden).

Alle Operationen sind idempotent – sie können jederzeit sicher erneut ausgeführt werden.

Öffnen Sie nach der Ausführung Claude Code und führen Sie /aide:init aus, um die Einrichtung abzuschließen.

Manuelle Konfiguration

Wenn Sie einen anderen Client als Claude Code verwenden oder die Konfiguration lieber manuell vornehmen möchten, fügen Sie den Servereintrag zur MCP-Konfigurationsdatei Ihres Clients hinzu.

Claude Code

claude mcp add aide npx -- -y @aidemd-mcp/server@latest

Oder fügen Sie es zu Ihrer .mcp.json im Projekt hinzu:

{
  "mcpServers": {
    "aide": {
      "command": "npx",
      "args": ["-y", "@aidemd-mcp/server@latest"]
    }
  }
}

Claude Desktop

Speicherorte der Konfigurationsdatei:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "aide": {
      "command": "npx",
      "args": ["-y", "@aidemd-mcp/server@latest"]
    }
  }
}

Claude Desktop erfordert nach jeder Konfigurationsänderung einen vollständigen Neustart.

Cursor

Hinzufügen zu ~/.cursor/mcp.json:

{
  "mcpServers": {
    "aide": {
      "command": "npx",
      "args": ["-y", "@aidemd-mcp/server@latest"]
    }
  }
}

VS Code / Copilot

Hinzufügen zu .vscode/mcp.json:

{
  "servers": {
    "aide": {
      "command": "npx",
      "args": ["-y", "@aidemd-mcp/server@latest"]
    }
  }
}

Windsurf

Hinzufügen zu ~/.windsurf/mcp.json:

{
  "mcpServers": {
    "aide": {
      "command": "npx",
      "args": ["-y", "@aidemd-mcp/server@latest"]
    }
  }
}

Tools

aide_discover

Durchsucht das Projekt nach .aide-Spezifikationsdateien und gibt eine Baumstruktur zur progressiven Offenlegung zurück, die den Typ, den Speicherort und die Zusammenfassung jeder Spezifikation anzeigt.

Eingaben:

• path (string, optional): Unterverzeichnis, in das hineingebohrt werden soll. Wenn angegeben, öffnet sich die Antwort mit der Vorfahren-Kette – der kaskadierenden Absichtslinie von der Wurzel bis zum Ziel, wobei jeder Vorfahre seine Beschreibung und seinen Ausrichtungsstatus anzeigt – gefolgt vom detaillierten Teilbaum mit Zusammenfassungen und Warnungen. Wenn weggelassen, wird eine flache projektweite Karte zurückgegeben (nur Speicherorte und Typen).

aide_read

Liest eine .aide-Spezifikationsdatei mit vollem Kontext und gibt den Dateiinhalt, den klassifizierten Typ (intent/research/plan/todo), verwandte Spezifikationen im selben Verzeichnis und im Inhalt gefundene Links zurück.

Eingaben:

• path (string, erforderlich): Pfad zur zu lesenden .aide-Datei.

aide_scaffold

Erstellt neue .aide-Spezifikationsdateien mit automatischer Durchsetzung von Namenskonventionen. Handhabt die Umbenennungsregeln: Absichtsspezifikationen sind standardmäßig .aide, werden aber zu intent.aide, wenn research.aide im selben Ordner existiert; das Erstellen einer research.aide benennt automatisch jede vorhandene .aide in intent.aide um.

Eingaben:

• directory (string, erforderlich): Verzeichnis, in dem die .aide-Datei(en) erstellt werden sollen.

• type (string, erforderlich): Typ der zu erstellenden .aide-Datei. Einer der folgenden: intent, research, both, todo, plan.

aide_validate

Führt eine Gesundheitsprüfung der .aide-Spezifikationsdateien im Projekt durch. Erkennt verwaiste Spezifikationen, fehlende Spezifikationen, Namenskonflikte (.aide und intent.aide im selben Ordner), defekte Links, verwaiste Recherchedateien und fehlende Frontmatter-Beschreibungen.

Eingaben:

• path (string, optional): Zu validierendes Unterverzeichnis. Standardmäßig das gesamte Projekt, wenn weggelassen.

aide_init

Bootstrappt die AIDE-Entwicklungsumgebung in ein Projekt mithilfe eines geführten Assistenten. Beim ersten Aufruf (keine category) wird eine Zusammenfassung jedes Schritts mit Status und erkanntem Framework zurückgegeben. Bei nachfolgenden Aufrufen (mit category) werden alle ausstehenden Dateien für diese Kategorie auf die Festplatte geschrieben und ein Manifest zurückgegeben.

Eingaben:

• framework (string, optional): Erzwingt ein bestimmtes Framework anstelle der automatischen Erkennung. Eines der folgenden: claude, cursor, windsurf, copilot.

• path (string, optional): Benutzerdefinierter Projekt-Wurzelpfad. Standardmäßig das Arbeitsverzeichnis des Servers.

• category (string, optional): Schreibt alle would-create-Dateien für diese Kategorie und gibt ein Manifest zurück. Eines der folgenden: framework, methodology, commands, agents, skills, mcp, brain, ide. Beim ersten Aufruf weglassen, um eine reine Metadaten-Zusammenfassung zu erhalten.

• brainPath (string, optional): Aufgelöster Pfad zum Brain-Vault. Erforderlich, wenn category=brain.

aide_upgrade

Vergleicht die AIDE-Methodik-Artefakte in diesem Projekt mit kanonischen Versionen und gibt ein strukturiertes Diff zurück, gruppiert nach Kategorie. Beim ersten Aufruf (keine category) wird eine leichtgewichtige Zusammenfassung jeder Kategorie mit Abweichungsstatus zurückgegeben. Bei nachfolgenden Aufrufen (mit category) werden alle geänderten oder fehlenden Dateien für diese Kategorie auf die Festplatte geschrieben und ein Manifest zurückgegeben.

Eingaben:

• framework (string, optional): Erzwingt ein bestimmtes Framework anstelle der automatischen Erkennung. Eines der folgenden: claude, cursor, windsurf, copilot.

• path (string, optional): Benutzerdefinierter Projekt-Wurzelpfad. Standardmäßig das Arbeitsverzeichnis des Servers.

• category (string, optional): Schreibt alle abweichenden oder fehlenden Dateien für diese Kategorie und gibt ein Manifest zurück. Eines der folgenden: pointer-stub, methodology-docs, version-metadata, commands, agents, skills, mcp, ide. Beim ersten Aufruf weglassen, um eine reine Metadaten-Zusammenfassung zu erhalten.

Erste Schritte

Nachdem Sie den Server zu Ihrem MCP-Client hinzugefügt haben, bitten Sie Ihren Agenten, aide_init auszuführen, um die AIDE-Methodik in Ihr Projekt zu bootstrappen. Dies installiert die Methodik-Dokumente, erstellt Pipeline-Befehle und richtet alles ein.

Versuchen Sie dann: "Scaffold an intent spec for my authentication module" – der Agent verwendet aide_discover, um Ihr Projekt abzubilden, und aide_scaffold, um die Spezifikation an der richtigen Stelle mit den richtigen Namenskonventionen zu erstellen.

Entwicklung

npm install
npm run build
npm test

Lizenz

MIT