ellmos-ai/ellmos-codecommander-mcp

**🇩🇪 Deutsche Version**
*Part of the ellmos-ai family.*
> [!NOTE]
> **For AI Assistants & LLMs:** Machine-readable indexing documentation for this repository is available at llms.txt. The server exposes 23 specialized tools under the cc_ prefix.
A developer-focused **Model Context Protocol (MCP) server** that gives AI assistants code analysis, structural Python editing, JSON repair, encoding fix, import organization, format conversion, file diff, and regex testing capabilities.
**23 tools** optimized for developers - the coding companion to FileCommander.
**Discoverability:** Published on npm as ellmos-codecommander-mcp, visible on Glama, and prepared for the official MCP Registry with server.json under io.github.ellmos-ai/ellmos-codecommander-mcp. Registry and directory manifests server.json, glama.json, smithery.yaml, and llms.txt are maintained in full parity.
---
Quick Navigation
1. Overview & Highlights
2. Target Personas & Discoverability
3. Comparative Matrix vs. Alternatives
4. Architecture & System Overview
5. Safe Structural Edit Lifecycle
6. Governance & Runtime Invariants
7. Developer Tool Suite (23 Tools)
8. Shared Tools with FileCommander
9. Installation & Quickstart
10. Configuration & MCP Client Setup
11. Multi-Language Support (i18n)
12. Development & Quality Assurance
13. Sibling Ecosystem & Partner Matrix
14. Third-Party Licenses & Transparency
15. Security Policy & Response SLA
16. Changelog & Version History
17. License & Legal Attribution
18. Statutory Notice, Liability Limitation & SLA (§ 521 BGB)
---
1. Overview & Highlights
While FileCommander handles filesystem operations and system processes, CodeCommander focuses specifically on **code intelligence and developer precision**:
- **Python, JavaScript & TypeScript Analysis** — Extension-dispatched classes, methods, functions, complexity metrics, and import analysis; JS/TS analysis is regex-based and read-only.
- **BACH-derived Python Helpers** — Runtime import diagnostics, structural edits, indentation checks, and template-based code generation.
- **Explicit Language Gates** — Python-only path tools reject non-.py files explicitly instead of producing Python-shaped false findings.
- **JSON Repair & Validation** — Automatically repair broken JSON (trailing commas, single quotes, BOM, comments) with precise error locations.
- **PEP 8 Import Organization** — Sort and deduplicate Python imports per PEP 8 guidelines.
- **Encoding & Mojibake Repair** — Fix Mojibake and double-encoded UTF-8 (27+ patterns) and broken German characters (70+ umlaut patterns).
- **Universal Format Conversion** — Convert between JSON, CSV, INI, YAML, TOML, XML, and TOON formats losslessly.
- **Unified File Diff** — Compare two files with LCS unified diff output and configurable context lines.
- **Regex Testing Workbench** — Test regular expressions with match details, capturing groups, and replace previews.
- **Markdown Export** — Convert Markdown to standalone HTML or PDF with syntax-styled code blocks, tables, and blockquotes.
- **Cross-Platform Native** — Full support on Windows, macOS, and Linux.
---
2. Target Personas & Discoverability
CodeCommander MCP is engineered to address key bottlenecks in modern autonomous AI coding, local multi-agent swarms, and safety-compliant developer tooling:
Target Audience & Stakeholder Personas
- **[PERSONA-01] ([PERSONA-1]) Autonomous AI Coding Agents & LLM Pair-Programmers**
- **Profile:** Agents such as Claude Code, Antigravity, Codex, Cursor, and Windsurf performing automated code refactoring, test repair, and feature development.
- **Pain Point:** Standard LLM code outputs frequently suffer from hallucinated imports, broken indentation in complex Python control flows, invalid JSON configs, or syntax corruption during naive chunk edits.
- **Solution:** Native AST extraction (cc_extract_classes, cc_analyze_methods), preview-safe structural editing with unified diffs (cc_python_structural_edit), automatic indentation checking (cc_check_indentation), and deterministic JSON repair (cc_fix_json).
- **[PERSONA-02] ([PERSONA-2]) Full-Stack & Python/TypeScript Software Engineers**
- **Profile:** Developers maintaining polyglot projects, CLI utilities, and data pipelines requiring cross-language AST analysis and rapid configuration format transitions.
- **Pain Point:** Tedious manual format conversions (JSON ↔ YAML ↔ TOML ↔ TOON ↔ XML), broken German umlauts or Mojibake from legacy encodings, and circular runtime imports.