🗺️ CodeAtlas MCP-Server

npm version License TypeScript Node

Ein eigenständiger MCP-Server, der CodeAtlas-Analysedaten für KI-Assistenten bereitstellt — Gemini, Claude, Cursor, Windsurf, VS Code Copilot und mehr.

NEU in v1.4.0: 🧠 KI-Systemgedächtnis — Die KI merkt sich Ihren Systemablauf über verschiedene Konversationen hinweg.

⚡ Schnellstart

1. Analysieren Sie Ihr Projekt

Installieren Sie die CodeAtlas VS Code-Erweiterung und führen Sie dann Folgendes aus:

Ctrl+Shift+P → CodeAtlas: Analyze Project

Dies generiert .codeatlas/analysis.json im Stammverzeichnis Ihres Projekts.

2. MCP-Konfiguration hinzufügen

Wählen Sie Ihren KI-Assistenten aus und fügen Sie die Konfiguration hinzu:

Öffnen Sie die Einstellungen (Ctrl+,) → suchen Sie nach mcp → klicken Sie auf In settings.json bearbeiten und fügen Sie dann Folgendes hinzu:

{
  "mcp": {
    "servers": {
      "codeatlas": {
        "command": "npx",
        "args": ["-y", "@giauphan/codeatlas-mcp"]
      }
    }
  }
}

Oder fügen Sie es über die arbeitsbereichsspezifische .vscode/settings.json für eine projektbezogene Konfiguration hinzu.

Fügen Sie dies zu .gemini/settings.json hinzu:

{
  "mcpServers": {
    "codeatlas": {
      "command": "npx",
      "args": ["-y", "@giauphan/codeatlas-mcp"]
    }
  }
}

Fügen Sie dies zu claude_desktop_config.json hinzu:

{
  "mcpServers": {
    "codeatlas": {
      "command": "npx",
      "args": ["-y", "@giauphan/codeatlas-mcp"]
    }
  }
}

Fügen Sie dies zu .cursor/mcp.json hinzu:

{
  "mcpServers": {
    "codeatlas": {
      "command": "npx",
      "args": ["-y", "@giauphan/codeatlas-mcp"]
    }
  }
}

Fügen Sie dies zu .windsurf/mcp.json hinzu:

{
  "mcpServers": {
    "codeatlas": {
      "command": "npx",
      "args": ["-y", "@giauphan/codeatlas-mcp"]
    }
  }
}

Das war's! Ihr KI-Assistent kann nun Ihre Codebasis-Struktur, Abhängigkeiten und Erkenntnisse abfragen.

🛠️ Verfügbare Tools

Code-Analyse (6 Tools)

Tool	Beschreibung
`list_projects`	Listet alle analysierten Projekte auf (automatische Erkennung unter `~/`)
`get_project_structure`	Ruft Module, Klassen, Funktionen und Variablen ab
`get_dependencies`	Ruft Import-/Aufruf-/Enthaltungsbeziehungen ab
`get_insights`	Ruft KI-generierte Erkenntnisse zur Codequalität ab
`search_entities`	Sucht Funktionen und Klassen nach Namen (Fuzzy-Suche)
`get_file_entities`	Ruft alle in einer bestimmten Datei definierten Entitäten ab

🧠 KI-Systemgedächtnis (3 Tools — NEU in v1.4.0)

Tool	Beschreibung
`generate_system_flow`	Automatische Generierung von Mermaid-Architekturdiagrammen. Bereiche: `modules-only`, `full`, `feature`
`sync_system_memory`	Erstellt/aktualisiert den Ordner `.agents/memory/` — das persistente Langzeitgedächtnis der KI
`trace_feature_flow`	Verfolgt den Ablauf eines Features durch die Codebasis. Gibt Dateien in Abhängigkeitsreihenfolge zurück

🧠 KI-Systemgedächtnis

KI-Assistenten verlieren den Kontext zwischen Konversationen. CodeAtlas MCP löst dies mit persistenten Gedächtnisdateien.

Funktionsweise

Conversation 1 → AI writes code → calls sync_system_memory
                                          │
                                   .agents/memory/
                                   ├── system-map.md
                                   ├── modules.json
                                   ├── business-rules.json
                                   ├── conventions.md
                                   ├── feature-flows.json
                                   └── change-log.json
                                          │
Conversation 2 → AI reads .agents/memory/ → knows full system flow instantly

KI-Gedächtnis einrichten

Kopieren Sie Regelvorlagen in Ihr Projekt:

mkdir -p /path/to/your-project/.agents/rules/

Erstellen Sie .agents/rules/auto-memory.md mit der Regel, die die KI anweist:
- .agents/memory/ zu Beginn jeder Konversation zu lesen
- trace_feature_flow vor Änderungen zu verwenden
- sync_system_memory nach Abschluss von Änderungen aufzurufen
Führen Sie sync_system_memory einmal aus, um den ersten Gedächtnis-Snapshot zu generieren.

📖 Vollständige Einrichtungsanleitung & Regelvorlagen: CodeAtlas-Dokumentation

📦 Alternative: Globale Installation

Wenn Sie eine globale Installation anstelle von npx bevorzugen:

npm install -g @giauphan/codeatlas-mcp

Verwenden Sie dann "command": "codeatlas-mcp" (keine args erforderlich) in Ihrer MCP-Konfiguration.

🔧 Umgebungsvariablen

Variable	Beschreibung
`CODEATLAS_PROJECT_DIR`	Erzwingt ein bestimmtes Projektverzeichnis

Standardmäßig erkennt der Server automatisch alle Projekte mit .codeatlas/analysis.json in Ihrem Home-Verzeichnis.

🌐 Unterstützte Sprachen

Sprache	Funktionen
TypeScript / JavaScript	Vollständiger AST: Importe, Klassen, Funktionen, Variablen, Aufrufe
Python	Klassen, Funktionen, Variablen, Importe, Aufrufe
PHP	Klassen, Interfaces, Traits, Enums, Funktionen, Eigenschaften, Konstanten
Blade Templates	`@extends`, `@include`, `@component`, `<x-component>`

🧑💻 Entwicklung

git clone https://github.com/giauphan/codeatlas-mcp.git
cd codeatlas-mcp
npm install
npm run build
npm start

Lizenz

MIT

CodeAtlas MCP Server