# ellmos CodeCommander MCP Server **🇬🇧 [English Version](README.md)** *Teil der [ellmos-ai](https://github.com/ellmos-ai) Familie.* [](https://opensource.org/licenses/MIT) [](https://www.npmjs.com/package/ellmos-codecommander-mcp) [](https://github.com/ellmos-ai/ellmos-codecommander-mcp/actions/workflows/tests.yml) [](https://nodejs.org/) Ein entwicklerfokussierter **Model Context Protocol (MCP) Server**, der KI-Assistenten Fähigkeiten für Code-Analyse, strukturelles Python-Editing, JSON-Reparatur, Encoding-Korrektur, Import-Organisation, Formatkonvertierung, Datei-Vergleich und Regex-Tests verleiht. **21 Tools** optimiert für Entwickler – das Coding-Gegenstück zu [FileCommander](https://github.com/ellmos-ai/ellmos-filecommander-mcp). **Auffindbarkeit:** Veröffentlicht auf [npm](https://www.npmjs.com/package/ellmos-codecommander-mcp) als `ellmos-codecommander-mcp`, auf [Glama](https://glama.ai/mcp/servers/b9kjs4uaav) sichtbar und mit [`server.json`](server.json) für die offizielle MCP Registry unter `io.github.ellmos-ai/ellmos-codecommander-mcp` vorbereitet. --- ## Warum CodeCommander? Während FileCommander Dateisystem-Operationen übernimmt, konzentriert sich CodeCommander auf **Code-Intelligenz**: - **Python Code-Analyse** – AST-basierte Klassen-/Methodenextraktion, Komplexitätsmetriken, Import-Analyse - **BACH-abgeleitete Python-Helfer** – Runtime-Importdiagnose, strukturelle Edits, Einrückungsprüfung und Template-basierte Codegenerierung - **JSON-Reparatur** – Automatische Korrektur von fehlerhaftem JSON (Trailing Commas, einfache Anführungszeichen, BOM, Kommentare) - **Import-Organisation** – Python-Imports sortieren und deduplizieren gemäß PEP 8 - **Encoding-Korrektur** – Reparatur von Mojibake und doppelt kodiertem UTF-8 (27+ Muster) - **Umlaut-Reparatur** – Korrektur defekter deutscher Umlaute (70+ Muster) - **Formatkonvertierung** – Konvertierung zwischen JSON, CSV, INI, YAML, TOML, XML und TOON - **Datei-Vergleich** – Zwei Dateien vergleichen mit Unified-Diff-Ausgabe (LCS-Algorithmus) - **Regex-Tester** – Reguläre Ausdrücke testen mit Match-Details, Gruppen und Ersetzungsvorschau - **Markdown-Export** – Markdown zu professionellem HTML/PDF konvertieren mit Code-Blöcken, Tabellen, verschachtelten Listen, Zitaten - **Plattformübergreifend** – Funktioniert unter Windows, macOS und Linux --- ## Installation ### Voraussetzungen - [Node.js](https://nodejs.org/) 18 oder höher ### Option 1: Installation über NPM ```bash npm install -g ellmos-codecommander-mcp ``` ### Option 2: Installation aus dem Quellcode ```bash git clone https://github.com/ellmos-ai/ellmos-codecommander-mcp.git cd ellmos-codecommander-mcp npm install npm run build ``` --- ## Konfiguration ### Claude Desktop Zur `claude_desktop_config.json` hinzufügen: **Windows:** `%APPDATA%\Claude\claude_desktop_config.json` **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json` #### Bei globaler Installation über NPM: ```json { "mcpServers": { "codecommander": { "command": "ellmos-codecommander" } } } ``` #### Bei Installation aus dem Quellcode: ```json { "mcpServers": { "codecommander": { "command": "node", "args": ["/absoluter/pfad/zu/ellmos-codecommander-mcp/dist/index.js"] } } } ``` ### Beide Server zusammen nutzen FileCommander und CodeCommander sind für den parallelen Einsatz konzipiert: ```json { "mcpServers": { "filecommander": { "command": "ellmos-filecommander" }, "codecommander": { "command": "ellmos-codecommander" } } } ``` --- ## Tool-Übersicht ### Code-Analyse (3 Tools) | Tool | Beschreibung | |------|-------------| | `cc_analyze_code` | Vollständige Code-Analyse: Klassen, Funktionen, Imports, LOC, Komplexität | | `cc_analyze_methods` | Detaillierte Methodenanalyse: Parameter, Decorators, Sichtbarkeit, Datenfluss, BACH-Prüfungen | | `cc_extract_classes` | Python-Klassen/-Funktionen als separate Textblöcke extrahieren, optional mit pycutter-artigem Inline-Inhalt | ### Import-Verwaltung (3 Tools) | Tool | Beschreibung | |------|-------------| | `cc_organize_imports` | Python-Imports sortieren & deduplizieren gemäß PEP 8 | | `cc_diagnose_imports` | Ungenutzte Imports, Duplikate und zirkuläre Import-Risiken erkennen | | `cc_runtime_import_diagnose` | Python-Runtime-Imports isoliert mit Timeouts, __init__.py-Analyse und Zirkularitäts-Hinweisen prüfen | ### JSON-Tools (2 Tools) | Tool | Beschreibung | |------|-------------| | `cc_fix_json` | Fehlerhaftes JSON reparieren (BOM, Trailing Commas, Kommentare, einfache Anführungszeichen) | | `cc_validate_json` | JSON validieren mit detaillierter Fehlerposition und Kontext | ### Encoding & Text (3 Tools) | Tool | Beschreibung | |------|-------------| | `cc_fix_encoding` | Mojibake / doppelt kodiertes UTF-8 reparieren (27+ Muster) | | `cc_cleanup_file` | BOM, NUL-Bytes, nachgestellte Leerzeichen entfernen, Zeilenenden normalisieren | | `cc_fix_umlauts` | Defekte deutsche Umlaute reparieren (70+ Muster, HTML-Entities, Escape-Sequenzen) | ### Scanning (1 Tool) | Tool | Beschreibung | |------|-------------| | `cc_scan_emoji` | Dateien nach Emojis mit Codepoint-Informationen durchsuchen | ### Format & Dokumentation (2 Tools) | Tool | Beschreibung | |------|-------------| | `cc_convert_format` | Konvertierung zwischen JSON, CSV, INI, YAML, TOML, XML und TOON | | `cc_generate_licenses` | Drittanbieter-Lizenzdatei generieren (npm/pip) | ### Entwickler-Werkzeuge (2 Tools) | Tool | Beschreibung | |------|-------------| | `cc_diff_files` | Zwei Dateien vergleichen mit Unified-Diff-Ausgabe (konfigurierbare Kontextzeilen) | | `cc_regex_test` | Regex-Muster gegen Text/Dateien testen mit Match-Details, Gruppen und Ersetzungsvorschau | ### Python-Assistenz (3 Tools) | Tool | Beschreibung | |------|-------------| | `cc_check_indentation` | Fehlende Doppelpunkte, unindentierte return/yield-Zeilen und gemischte Tab-/Leerzeichen-Einrückung erkennen | | `cc_generate_python_code` | Python-Funktionen, Klassen, Dataclasses, CLI-Stubs, Tests, Exceptions und Module aus Templates erzeugen | | `cc_python_structural_edit` | Strukturelle Python-Edits mit Vorschau, Testdatei, Syntaxprüfung und Backup-Modus prüfen und anwenden | ### Export (2 Tools) | Tool | Beschreibung | |------|-------------| | `cc_md_to_html` | Markdown zu eigenständigem HTML mit CSS-Styling (Überschriften, Code-Blöcke, Tabellen, verschachtelte Listen, Zitate, Bilder, Checkboxen) | | `cc_md_to_pdf` | Markdown zu PDF über Headless-Browser (Edge/Chrome). Fallback auf HTML wenn kein Browser verfügbar | **Gesamt: 21 Entwickler-Tools** (`cc_set_language` ist zusätzlich für Sprachumschaltung verfügbar) --- ## Gemeinsame Tools 7 Tools existieren sowohl in FileCommander als auch in CodeCommander zur einfacheren Nutzung: | FileCommander | CodeCommander | Funktion | |---------------|---------------|----------| | `fc_fix_json` | `cc_fix_json` | JSON-Reparatur | | `fc_validate_json` | `cc_validate_json` | JSON-Validierung | | `fc_fix_encoding` | `cc_fix_encoding` | Encoding-Reparatur | | `fc_cleanup_file` | `cc_cleanup_file` | Datei-Bereinigung | | `fc_convert_format` | `cc_convert_format` | Formatkonvertierung (JSON/CSV/INI/YAML/TOML/XML/TOON) | | `fc_md_to_html` | `cc_md_to_html` | Markdown zu HTML Export | | `fc_md_to_pdf` | `cc_md_to_pdf` | Markdown zu PDF Export | --- ## Tool-Präfix Alle Tools verwenden das Präfix `cc_` (CodeCommander), um Konflikte mit dem `fc_`-Präfix von FileCommander und anderen MCP-Servern zu vermeiden. --- ## Sicherheit Siehe [SECURITY.md](SECURITY.md) für detaillierte Sicherheitsinformationen. Wichtige Punkte: - Dateiverändernde Tools unterstützen Vorschau-/Dry-run-Modi, wo anwendbar - Backup-Erstellung ist standardmäßig bei destruktiven Operationen aktiviert - Kein integriertes Sandboxing – die Sicherheit wird an den MCP-Client delegiert - Konzipiert für die lokale Entwicklungsnutzung über stdio-Transport --- ## Entwicklung ```bash npm install npm run dev # Watch-Modus npm run build # Einmaliger Build npm start # Server starten npm test # Tests ausführen (vitest) ``` ### Tests Das Projekt enthält eine umfassende Test-Suite für alle 21 Entwickler-Tools und i18n-Verhalten. ```bash npm test # Alle Tests ausführen npx vitest --watch # Watch-Modus ``` Tests sind auf **Windows**, **macOS** und **Linux** verifiziert. GitHub Actions führt Build, Vitest-Suite und npm-Paketprüfung auf Node.js 20, 22 und 24 aus. --- ## Änderungsprotokoll Siehe [CHANGELOG.md](CHANGELOG.md) für die vollständige Versionshistorie. --- ## Lizenz [MIT](LICENSE) - Lukas Geiger ([ellmos-ai](https://github.com/ellmos-ai)) --- ## Geschichte Dieses Projekt wurde ursprünglich als **BACH CodeCommander** (`bach-codecommander-mcp`) entwickelt. Es wurde im Rahmen der [ellmos-ai](https://github.com/ellmos-ai) Organisation zu **ellmos CodeCommander** (`ellmos-codecommander-mcp`) umbenannt. Der alte Paketname `bach-codecommander-mcp` ist veraltet. Bitte verwenden Sie stattdessen [`ellmos-codecommander-mcp`](https://www.npmjs.com/package/ellmos-codecommander-mcp): ```bash npm uninstall -g bach-codecommander-mcp npm install -g ellmos-codecommander-mcp ``` --- ## ellmos-ai-Ökosystem Dieser MCP-Server ist Teil des **[ellmos-ai](https://github.com/ellmos-ai)**-Ökosystems: KI-Infrastruktur, MCP-Server und intelligente Werkzeuge. ### MCP-Server-Familie | Server | Tools | Fokus | npm | |--------|-------|-------|-----| | [FileCommander](https://github.com/ellmos-ai/ellmos-filecommander-mcp) | 44 | Dateisystem, Prozessverwaltung, interaktive Sitzungen | [`ellmos-filecommander-mcp`](https://www.npmjs.com/package/ellmos-filecommander-mcp) | | **[CodeCommander](https://github.com/ellmos-ai/ellmos-codecommander-mcp)** | **21** | **Code-Analyse, AST-Parsing, Import-Verwaltung** | **[`ellmos-codecommander-mcp`](https://www.npmjs.com/package/ellmos-codecommander-mcp)** | | [Clatcher](https://github.com/ellmos-ai/ellmos-clatcher-mcp) | 12 | Dateireparatur, Formatkonvertierung, Batch-Operationen | [`ellmos-clatcher-mcp`](https://www.npmjs.com/package/ellmos-clatcher-mcp) | | [n8n Manager](https://github.com/ellmos-ai/n8n-manager-mcp) | 18 | n8n-Workflow-Verwaltung über KI-Assistenten | [`n8n-manager-mcp`](https://www.npmjs.com/package/n8n-manager-mcp) | | [ControlCenter](https://github.com/ellmos-ai/ellmos-controlcenter-mcp) | 10 | MCP-Stack-Discovery, Profilverwaltung, Control Plane | [`ellmos-controlcenter-mcp`](https://www.npmjs.com/package/ellmos-controlcenter-mcp) | ### KI-Infrastruktur | Projekt | Beschreibung | |---------|-------------| | [BACH](https://github.com/ellmos-ai/bach) | Textbasiertes Betriebssystem für LLMs: Handler, Tools und Skills | | [clutch](https://github.com/ellmos-ai/clutch) | Provider-neutrale LLM-Orchestrierung mit Auto-Routing und Budget-Tracking | | [rinnsal](https://github.com/ellmos-ai/rinnsal) | Leichte Agent-Memory-, Connector- und Automatisierungsinfrastruktur | | [ellmos-stack](https://github.com/ellmos-ai/ellmos-stack) | Self-hosted AI Research Stack | | [MarbleRun](https://github.com/ellmos-ai/MarbleRun) | Autonomes Agent-Chain-Framework für Claude Code | | [gardener](https://github.com/ellmos-ai/gardener) | Minimalistischer datenbankgetriebener LLM-OS-Prototyp | | [ellmos-tests](https://github.com/ellmos-ai/ellmos-tests) | Testframework für LLM-Betriebssysteme | ### Desktop-Software Unsere Partnerorganisation **[open-bricks](https://github.com/open-bricks)** bündelt KI-native Desktop-Anwendungen: eine moderne Open-Source-Softwaresuite für Datei-, Dokumenten- und Entwicklerwerkzeuge. --- ## Haftung Dieses Projekt ist eine **unentgeltliche Open-Source-Schenkung** im Sinne der §§ 516 ff. BGB. Die Haftung des Urhebers ist gemäß **§ 521 BGB** auf **Vorsatz und grobe Fahrlässigkeit** beschränkt. Ergänzend gilt der Haftungsausschluss der MIT-Lizenz. Nutzung auf eigenes Risiko. Keine Wartungszusage, keine Verfügbarkeitsgarantie, keine Gewähr für Fehlerfreiheit oder Eignung für einen bestimmten Zweck.