ellmos-codecommander-mcp
This local-first MCP server provides 23 cc_ developer tools for code analysis, safe editing, repair, conversion, and export.
Analyze Python, JavaScript, and TypeScript files for classes, functions, imports, LOC, complexity, and methods.
Extract Python classes/functions and generate Python code templates.
Organize, diagnose, and runtime-test Python imports, including isolated subprocess diagnostics.
Check Python indentation and perform preview/test/apply structural Python edits with syntax checks and backups.
Repair and validate JSON; fix Mojibake/encoding issues, broken German umlauts, BOM/NULs, whitespace, and line endings.
Convert between JSON, CSV, INI, YAML, TOML, XML, and TOON.
Diff files with unified diff output and test regex patterns with groups and replacement previews.
Scan files for emojis and generate third-party license files for npm/Python projects.
Export Markdown to standalone HTML or PDF with HTML fallback.
Set and query runtime output language across 11 locales.
Run locally over stdio with preview-safe, backup-protected operations and no cloud egress.
Converts Markdown files to standalone HTML or PDF with styling support for code blocks, tables, lists, and blockquotes.
Generates third-party license files for npm projects by reading package.json and collecting license information.
Analyzes Python code to extract classes, methods, imports, and complexity metrics; also organizes imports per PEP 8 and diagnoses import issues.
Supports conversion between TOML and other formats such as JSON, CSV, INI, YAML, XML, and TOON.
Supports conversion between XML and other formats such as JSON, CSV, INI, YAML, TOML, and TOON.
Supports conversion between YAML and other formats such as JSON, CSV, INI, TOML, XML, and TOON.
ellmos CodeCommander MCP Server
English | Deutsch | Español | 简体中文 | 日本語 | Русский | Français | हिन्दी | العربية | বাংলা | Português
The README navigation lists the available documentation languages. Section 11 separately describes the runtime languages used for tool output messages and diagnostics. This does not claim that MCP discovery or schema descriptions, the GUI, CLI, or API are translated.
Part of the ellmos-ai family.
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
Related MCP server: mcp-dev-utils
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-
.pyfiles 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-ProgrammersProfile: 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 EngineersProfile: 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.
Solution: Universal format converter (
cc_convert_format), non-destructive encoding and umlaut repair (cc_fix_encoding,cc_fix_umlauts), isolated runtime import diagnostics (cc_runtime_import_diagnose), and interactive regex tester (cc_regex_test).
[PERSONA-03]([PERSONA-3]) Enterprise AI Safety, SecOps & Code Governance OfficersProfile: Security auditors, compliance engineers, and enterprise architects evaluating MCP toolchains for developer workstations and CI/CD runners.
Pain Point: Risk of confidential code leakage via cloud telemetry, unauthorized process elevation, or destructive in-place file overwrites by AI assistants.
Solution: 100% Zero-Egress local stdio transport (
INV-LOCAL-01), unprivileged user-space execution (INV-SEC-02), mandatory timestamped.bakbackups before mutations (INV-BAK-04), dry-run diff preview safety (INV-PREV-03), and isolated subprocess timeouts (INV-ISOL-05).
[PERSONA-04]([PERSONA-4]) Open-Source Ecosystem Architects & MCP Tool DevelopersProfile: Maintainers building, publishing, and indexing MCP servers across Glama, Smithery, npm, and GitHub.
Pain Point: Fragmented directory manifests, missing third-party license disclosures, and lack of machine-readable indexing context for AI agents.
Solution: 100% manifest parity across
package.json,server.json,glama.json,smithery.yaml, andllms.txt, verified by automated contract tests and a complete open-source license audit (THIRD_PARTY_LICENSES.md).
High-Intent Search Queries (SEO & Discoverability)
mcp code analysis servermodel context protocol python ast toolsmcp server codecommanderpython structural edit mcpclaude code developer mcp servermcp json repair and encoding fixlocal-first mcp tools for codingmcp python runtime import diagnoseformat converter mcp json yaml toml toonoffline code intelligence mcp server
3. Comparative Matrix vs. Alternatives
The following matrix compares CodeCommander MCP against alternative developer tooling approaches across 10 critical operational dimensions:
Dimension / Capability | Generic File MCP | Raw Shell / Ad-Hoc Scripts | Heavyweight Cloud LLMOps | Traditional IDE Plugins | ellmos CodeCommander MCP |
1. AST Code Intelligence | None (raw text reads) | Requires custom python scripts | Cloud parser required | Built-in (GUI only) | Native AST & regex JS/TS ( |
2. Safe Structural Edit Preview | None (blind overwrite) | High risk ( | Cloud gateway dependent | Interactive dialog | Preview-safe diffs ( |
3. Mandatory Pre-Mutation Backups | None | Manual scripting | None | Local history (opaque) | Automatic |
4. Runtime Import Diagnostics | None | Unsafe direct execution | None | Partial / static only | Isolated subprocess + timeout ( |
5. Encoding & Mojibake Recovery | None | Fragile | None | Basic encoding switch | 27+ Mojibake, 70+ Umlauts ( |
6. Universal Format Conversion | None | Multiple disparate CLI tools | SaaS conversion API | Multi-plugin setup | Lossless 7 formats ( |
7. Diff Engine & Regex Workbench | None | Basic | None | GUI panel only | LCS Unified Diff & Regex with groups/replace |
8. Local-First & Zero-Egress | Host-dependent | Local | Cloud egress / telemetry | Often connects to cloud | 100% Offline Stdio JSON-RPC ( |
9. Multi-Language (i18n) Support | English only | None | English only | Language packs | 11 runtime languages for tool output and diagnostic messages; switchable with |
10. Registry & Manifest Parity | Minimal | None | Proprietary | Marketplace specific | npm, Glama, Smithery, MCP Registry, |
4. Architecture & System Overview
+==============================================================================================================+
| FOUR-VIEW ARCHITECTURAL TOPOLOGY (STANDARDIZED LEVEL-1 SPECIFICATION) |
+==============================================================================================================+
| [VIEW 1: CLIENT RUNTIMES, USER INTERFACES & AGENT ENTRYPOINTS] |
| - Stdio JSON-RPC Clients: Claude Desktop, Claude Code CLI, Cursor, Windsurf, Codex, Antigravity, Kimi Code |
| - MCP Tool Ingestion: 23 Developer Tools via standard Model Context Protocol Specification |
| - Runtime locales: DE EN ES ZH JA RU FR HI AR BN PT (INV-I18N-09) |
+--------------------------------------------------------------------------------------------------------------+
| Stdio Transport (JSON-RPC)
v
+--------------------------------------------------------------------------------------------------------------+
| [VIEW 2: CODECOMMANDER MCP PROTOCOL & TOOL ENGINE] |
| - Code Intelligence AST: Python AST Class/Method Extractors, Complexity Metrics & Guardrails (INV-GATE-06) |
| - Structural Refactoring Engine: Preview-Safe Diffs & Dry-Run Syntax Verification (INV-PREV-03) |
| - Import Diagnostics & Organizer: PEP 8 Cleaners & Subprocess Import Probers (INV-ISOL-05) |
| - Universal Format Converter: Lossless Roundtrip across JSON/CSV/INI/YAML/TOML/XML/TOON (INV-FMT-08) |
| - Text & Encoding Heuristics: 27+ Mojibake & 70+ German Umlaut Restorations, JSON Fixers (INV-ENC-07) |
+--------------------------------------------------------------------------------------------------------------+
| Process Isolation & Local I/O
v
+--------------------------------------------------------------------------------------------------------------+
| [VIEW 3: RUNTIME PERSISTENCE, BACKUP VAULTS & ISOLATED SUBPROCESS RUNNERS] |
| - Pre-Mutation Safety Vault: Timestamped `.bak` Disk Backups Before In-Place Modification (INV-BAK-04) |
| - Ephemeral Python Runner: Isolated Child Processes with Strict Execution Timeout Bounds (INV-ISOL-05) |
| - Unified Diff Pipeline: LCS Algorithm Unified Diff Generator with Configurable Context Chunks |
| - Local Document Exporters: Self-Contained Markdown-to-HTML and Print-Safe PDF Artifact Generators |
+--------------------------------------------------------------------------------------------------------------+
| Containment & Perimeter Defense
v
+--------------------------------------------------------------------------------------------------------------+
| [VIEW 4: AIR-GAP DEFENSE PERIMETER, ZERO-EGRESS & RUNASINVOKER SECURITY BOUNDARY] |
| - Zero-Egress Network Isolation: 100% Offline Local Operation, Zero Sockets, Zero Cloud Telemetry (INV-LOCAL-01)|
| - Unprivileged User Mode: Standard RunAsInvoker Execution; Zero Root/Administrator Elevation (INV-SEC-02) |
| - Supply Chain & License Hygiene: Zero Copyleft, 100% Permissive Open Source Stack (MIT, BSD, Apache) |
| - Vulnerability Remediation SLA: 48h Response, 5-Day Triage & 30-Day Patch Commitment (INV-SLA-10) |
+==============================================================================================================+graph TD
Client["MCP Clients<br/>(Claude Desktop / Claude Code / Cursor / Windsurf)"]
Server["ellmos CodeCommander MCP Server<br/>(stdio transport • Node.js)"]
subgraph Tools["Developer Tool Suites (23 Tools)"]
subgraph CodeIntel["Code & Python Intelligence"]
C1["cc_analyze_code"]
C2["cc_analyze_methods"]
C3["cc_extract_classes"]
C4["cc_check_indentation"]
C5["cc_generate_python_code"]
C6["cc_python_structural_edit"]
end
subgraph Imports["Import Management"]
I1["cc_organize_imports"]
I2["cc_diagnose_imports"]
I3["cc_runtime_import_diagnose"]
end
subgraph Repair["Text, JSON & Encoding Repair"]
R1["cc_fix_json"]
R2["cc_validate_json"]
R3["cc_fix_encoding"]
R4["cc_cleanup_file"]
R5["cc_fix_umlauts"]
end
subgraph Utility["Utilities & Conversion"]
U1["cc_convert_format (JSON/CSV/YAML/TOML/XML/TOON)"]
U2["cc_diff_files (Unified Diff)"]
U3["cc_regex_test (Regex Tester)"]
U4["cc_scan_emoji"]
U5["cc_generate_licenses"]
end
subgraph Export["Export & i18n"]
E1["cc_md_to_html"]
E2["cc_md_to_pdf"]
E3["cc_set_language"]
E4["cc_get_language"]
end
end
Client -->|Stdio JSON-RPC| Server
Server --> CodeIntel
Server --> Imports
Server --> Repair
Server --> Utility
Server --> Export5. Safe Structural Edit Lifecycle
sequenceDiagram
autonumber
actor Developer as Developer / LLM Client
participant Stdio as CodeCommander Server (stdio)
participant Core as AST & Code Intelligence Core
participant Disk as Local Filesystem
Developer->>Stdio: cc_python_structural_edit (mode: "preview" / "apply")
Stdio->>Core: Parse Python AST & Validate Syntax
alt Validation Failed
Core-->>Stdio: Syntax / Parsing Diagnostics
Stdio-->>Developer: Error Diagnostics & Line References
else Validation Passed
Core->>Disk: Read Original File
Core->>Core: Compute Unified Structural Diff
alt Mode == "preview"
Core-->>Stdio: Return Diff Preview (Zero File Mutations)
Stdio-->>Developer: Structural Diff Preview
else Mode == "apply"
Core->>Disk: Create .bak Backup File
Core->>Disk: Write Modified AST Code In-Place
Core-->>Stdio: Confirmation with Applied Diff & Backup Path
Stdio-->>Developer: Success Payload
end
end6. Governance & Runtime Invariants
ellmos-codecommander-mcp guarantees 10 core architectural and runtime invariants across all platforms:
Invariant ID | Classification | Architectural Guarantee & Verification Mechanism |
| Zero-Egress Privacy | Pure local stdio JSON-RPC transport; zero network telemetry, cloud beacons, or remote egress. |
| Unprivileged Security | Standard user-space execution ( |
| Preview Safety | Structural edits default to non-mutating preview mode ( |
| Automatic Backups | File modifications automatically generate timestamped |
| Subprocess Isolation | Python runtime import diagnosis executes in isolated, timeout-bounded child processes. |
| Explicit Language Gates | Python-specific path tools reject non- |
| Non-Destructive Encoding | Repaired text restores 27+ Mojibake and 70+ German umlaut patterns without loss or binary corruption. |
| Format Interchange Parity | Lossless format conversions across JSON, CSV, INI, YAML, TOML, XML, and TOON with schema preservation. |
| Runtime Multi-Language | Switch among the 11 runtime languages for tool output and diagnostic messages with |
| 48h Security Response SLA | Verified across Ubuntu, Windows, macOS on Node 20, 22, 24 with public 48h response / 5-day triage commitment. |
7. Developer Tool Suite (23 Tools)
Code Analysis (3 tools)
Tool | Description |
| Read-only Python or regex-based JavaScript/TypeScript analysis: classes, functions, imports, LOC, complexity |
| Read-only Python or regex-based JavaScript/TypeScript method analysis; Python retains its BACH guardrails |
| Extract Python classes/functions as separate text blocks, optionally including pycutter-style inline content |
Import Management (3 tools)
Tool | Description |
| Sort & deduplicate Python imports per PEP 8 |
| Read-only Python or regex-based JavaScript/TypeScript import diagnostics |
| Run isolated Python runtime imports with timeouts, |
JSON Tools (2 tools)
Tool | Description |
| Repair broken JSON (BOM, trailing commas, comments, single quotes) |
| Validate JSON with detailed error position and context |
Encoding & Text (3 tools)
Tool | Description |
| Fix Mojibake / double-encoded UTF-8 (27+ patterns) |
| Remove BOM, NUL bytes, trailing whitespace, normalize line endings |
| Repair broken German umlauts (70+ patterns, HTML entities, escapes) |
Scanning (1 tool)
Tool | Description |
| Scan files for emojis with codepoint info |
Format & Documentation (2 tools)
Tool | Description |
| Convert between JSON, CSV, INI, YAML, TOML, XML, and TOON formats |
| Generate third-party license file (npm/pip) |
Developer Utilities (2 tools)
Tool | Description |
| Compare two files with unified diff output (configurable context lines) |
| Test regex patterns against text/files with match details, groups, and replace preview |
Python Assistance (3 tools)
Tool | Description |
| Detect missing colons, unindented return/yield statements, and mixed tab/space indentation |
| Generate Python functions, classes, dataclasses, CLI stubs, tests, exceptions, and modules from templates |
| Inspect and apply structural Python edits with preview, test-file, syntax-check and backup modes |
Export (2 tools)
Tool | Description |
| Markdown to standalone HTML with CSS styling (headers, code blocks, tables, nested lists, blockquotes, images, checkboxes) |
| Markdown to PDF via headless browser (Edge/Chrome). Falls back to HTML if no browser is available |
Runtime Language Management (2 tools)
Tool | Description |
| Set the language used for runtime tool output and diagnostic messages ( |
| Query currently active language and supported locale codes |
Total: 23 developer tools available under the cc_ prefix.
8. Shared Tools with FileCommander
7 tools exist in both FileCommander and CodeCommander for convenience:
FileCommander | CodeCommander | Function |
|
| JSON repair |
|
| JSON validation |
|
| Encoding repair |
|
| File cleanup |
|
| Format conversion (JSON/CSV/INI/YAML/TOML/XML/TOON) |
|
| Markdown to HTML export |
|
| Markdown to PDF export |
All tools in CodeCommander use the cc_ prefix to guarantee seamless coexistence with FileCommander's fc_ namespace.
9. Installation & Quickstart
Prerequisites
Node.js 20 or higher
npm 9 or higher
Option 1: Install from NPM (Recommended)
npm install -g ellmos-codecommander-mcpOption 2: Install from Source
git clone https://github.com/ellmos-ai/ellmos-codecommander-mcp.git
cd ellmos-codecommander-mcp
npm install
npm run build10. Configuration & MCP Client Setup
Claude Desktop
Add to your claude_desktop_config.json:
Windows:
%APPDATA%\Claude\claude_desktop_config.jsonmacOS:
~/Library/Application Support/Claude/claude_desktop_config.json
Global NPM Install:
{
"mcpServers": {
"codecommander": {
"command": "ellmos-codecommander"
}
}
}From Source Build:
{
"mcpServers": {
"codecommander": {
"command": "node",
"args": ["/absolute/path/to/ellmos-codecommander-mcp/dist/index.js"]
}
}
}Coexistence with FileCommander
FileCommander and CodeCommander are designed to run concurrently:
{
"mcpServers": {
"filecommander": {
"command": "ellmos-filecommander"
},
"codecommander": {
"command": "ellmos-codecommander"
}
}
}11. Multi-Language Support (i18n)
CodeCommander supports these 11 languages for messages returned by tools, including diagnostic messages at runtime:
de— German (default)en— Englishes— Spanishzh— Simplified Chineseja— Japaneseru— Russianfr— Frenchhi— Hindiar— Arabicbn— Bengalipt— Portuguese
These codes select the language of runtime tool output and diagnostic messages. They do not translate MCP discovery or schema descriptions, the GUI, CLI, or API; README navigation lists documentation languages separately.
CC_LANGUAGE selects the initial language when the server starts. During an active MCP session, use cc_set_language to switch languages; cc_get_language reports the active code and supported codes. If CC_LANGUAGE is unset or unsupported, the fallback is German (de). No --lang option is documented.
12. Development & Quality Assurance
npm install
npm run dev # TypeScript watch mode
npm run build # Compile TypeScript to dist/
npm start # Run built server via stdio
npm test # Run Vitest unit & contract suite (205 tests)
npm run test:integration # Real MCP stdio test suite (52 assertions, build first)
npm run test:i18n # Translation parity test suite (43 assertions)
npm run test:all # Run full QA pipeline (build + vitest + integration + i18n)The test gates are deliberately separated and automated in CI across Ubuntu, macOS, and Windows on Node.js 20, 22, and 24 (totaling 322 automated assertions, 100% green). Contribution workflow and development guidelines are detailed in CONTRIBUTING.md.
13. Sibling Ecosystem & Partner Matrix
Part of the ellmos-ai and open-bricks family of local-first tools:
MCP Server Family
Server | Tools | Focus | npm |
50 | Filesystem, process management, interactive sessions, cloud-lock-safe operations | ||
23 | Code analysis, AST edits, JSON repair, diff, regex | ||
12 | File repair, format conversion, batch operations | ||
19 | n8n workflow management via AI assistants | ||
34 | MCP stack discovery, profile management, control plane | ||
51 | Local-first LLM memory, knowledge, state, routing, swarm orchestration |
| |
8 | Server operations: health checks, log analysis, deploy dry-runs, mail diagnostics |
| |
4 | Headless Blender asset QA and FBX reimport verification |
| |
16 | Model-agnostic computer use: capture, safety-gated actions, Windows UIA |
|
Sibling Developer, File & Document Tools
Ecosystem | Tool / Project | Focus & Capabilities |
ellmos-ai | Offline SQLite change distribution with HMAC verification | |
ellmos-ai | Cryptographically signed delegation policies for AI agents | |
ellmos-ai | Provider-neutral LLM orchestration with auto-routing and budget tracking | |
ellmos-ai | Local-first text-based OS for LLM agents — 113+ handlers, 550+ tools | |
dev-bricks | PySide6 Developer Desktop Suite & offline secret vault | |
dev-bricks | Fast desktop code snippet manager & local AST indexing | |
dev-bricks | Method flow & complexity diagnostic engine | |
dev-bricks | Optional Windows tool for checking orphaned MCP processes. CodeCommander is a configured candidate when launched through the supported | |
doc-bricks | Desktop OCR pipeline for searchable PDFs with Tesseract | |
doc-bricks | Multi-format document workspace & offline PDF export | |
file-bricks | Multi-pane file management & bulk batch operations | |
open-bricks | Umbrella organization for AI-native desktop applications |
14. Third-Party Licenses & Transparency
This project strictly adheres to open-source transparency:
All runtime and development dependencies are audited in
THIRD_PARTY_LICENSES.mdand plain-text companionTHIRD_PARTY_LICENSES.txt.The current production dependency audit (
npm audit --omit=dev --json, checked 2026-09-20) reports 5 vulnerable package nodes (3 high, 2 moderate); remediation is tracked in TASKPLAN #2198.Distributed exclusively under permissive open-source licenses (MIT, BSD-2-Clause, BSD-3-Clause, Apache-2.0).
Comprehensive discoverability, personas, and marketing metrics are documented in
MARKETING-LOG.txt.Zero proprietary tracking, zero telemetric beacons, and zero viral copyleft dependencies.
15. Security Policy & Response SLA
Please review SECURITY.md for full vulnerability disclosure procedures.
Zero-Egress Guarantee: Completely local execution over stdio.
Preview & Backup Safety: Destructive operations create
.bakbackups and support non-mutating preview.Unprivileged User Mode: Runs under standard unprivileged user permissions (
RunAsInvoker).Dedicated Response Channels: Contact
security@ellmos.aiandsupport@lukasgeiger.comwith a guaranteed 48-hour initial response SLA and 5-day triage commitment.
16. Changelog & Version History
See CHANGELOG.md for release notes and version history.
17. License & Legal Attribution
This project is licensed under the MIT License — Copyright © 2026 Lukas Geiger (ellmos-ai).
See NOTICE for open-bricks umbrella attribution, CONTRIBUTING.md for development guidelines, and THIRD_PARTY_LICENSES.md / THIRD_PARTY_LICENSES.txt for the Level 1 SBOM invariant inventory.
18. Statutory Notice, Liability Limitation & SLA (§ 521 BGB)
Dieses Projekt ist eine unentgeltliche Open-Source-Schenkung im Sinne der §§ 516 ff. BGB (Gefälligkeitsrecht). Die Haftung des Urhebers und der Mitwirkenden 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.
Sicherheitsrelevante Vorfälle und Schwachstellen werden über das verbindliche 48-Stunden-SLA unter security@open-bricks.org, security@ellmos.ai und support@lukasgeiger.com entgegengenommen und innerhalb von 5 Werktagen triagiert.
This project is an unpaid open-source donation under German law (§§ 516 et seq. BGB). Liability is strictly limited to intent and gross negligence (§ 521 German Civil Code). The MIT license disclaimer applies complementarily. Use at your own risk. No warranty, no maintenance guarantee, no fitness-for-purpose assumed.
Security incidents and vulnerabilities are handled under a binding 48-hour response SLA via security@open-bricks.org, security@ellmos.ai and support@lukasgeiger.com with formal triage within 5 business days.
Available Tools
23 toolscc_analyze_codeAnalyze CodeARead-onlyIdempotent
Analyzes a Python, JavaScript, or TypeScript file: classes, functions, imports, metrics.
Args:
path (string): Path to a .py, .js/.jsx/.mjs/.cjs, or .ts/.tsx/.mts/.cts file
Returns:
Classes with methods, functions, import analysis, LOC, complexity
Inputs: path (required).
cc_analyze_methodsAnalyze MethodsARead-onlyIdempotent
Detailed method analysis of a Python, JavaScript, or TypeScript file.
Args:
path (string): Path to a .py, .js/.jsx/.mjs/.cjs, or .ts/.tsx/.mts/.cts file
class_name (string, optional): Only methods of this class
Returns:
Methods with parameters and visibility; Python analysis also includes decorators, complexity, data flow, and BACH guardrails
Inputs: path (required), class_name.
cc_check_indentationCheck Python IndentationBRead-onlyIdempotent
Prüft Python-Dateien auf fehlende Doppelpunkte, unindentierte return/yield-Zeilen und gemischte Tab-/Leerzeichen-Einrückung
Inputs: path (required), recursive, max_issues.
cc_cleanup_fileCleanup FileBIdempotent
Cleans up source code files: BOM, NUL bytes, trailing whitespace, line endings.
Args:
path (string): Path to the file
remove_bom (boolean): Remove BOM
remove_trailing_whitespace (boolean): Trailing whitespace
normalize_line_endings (string): "lf" | "crlf"
remove_nul_bytes (boolean): Remove NUL bytes
dry_run (boolean): Preview only
Inputs: path (required), dry_run, remove_bom, remove_nul_bytes, +2 more.
cc_convert_formatConvert FormatCIdempotent
Converts between JSON, CSV, INI, YAML, TOML, XML, and TOON formats.
Args:
input_path (string): Source file
output_path (string): Target file
input_format (string): "json" | "csv" | "ini" | "yaml" | "toml" | "xml" | "toon"
output_format (string): "json" | "csv" | "ini" | "yaml" | "toml" | "xml" | "toon"
json_indent (number): JSON indentation
Inputs: input_path (required), output_path (required), input_format (required), output_format (required), +1 more.
cc_diagnose_importsDiagnose ImportsARead-onlyIdempotent
Diagnoses import issues in Python, JavaScript, or TypeScript files.
Args:
path (string): Path to a .py, .js/.jsx/.mjs/.cjs, or .ts/.tsx/.mts/.cts file
Detects: Unused bindings, duplicates, relative-import risks, and import-order issues
Inputs: path (required).
cc_diff_filesDiff FilesBRead-onlyIdempotent
Vergleicht zwei Dateien und zeigt Unterschiede im Unified-Diff-Format
Inputs: file_a (required), file_b (required), context_lines.
cc_extract_classesExtract ClassesBIdempotent
Extracts Python classes and functions from a file as separate text blocks.
Args:
path (string): Path to the Python file
output_dir (string, optional): Output directory (otherwise display only)
include_content (boolean, optional): Include pycutter-style code blocks in the response
max_chars (number, optional): Maximum response characters for included code
Useful for code review and documentation.
Inputs: path (required), max_chars, output_dir, include_content.
cc_fix_encodingFix EncodingCIdempotent
Repairs encoding errors (Mojibake, double UTF-8).
Args:
path (string): Path to the file
dry_run (boolean): Preview only
create_backup (boolean): Create backup
Repairs 27+ Mojibake patterns (German, French, Spanish).
Inputs: path (required), dry_run, create_backup.
cc_fix_jsonFix JSONAIdempotent
Automatically repairs common JSON errors.
Args:
path (string): Path to the JSON file
dry_run (boolean): Only show issues
create_backup (boolean): Create backup
Repairs: BOM, trailing commas, single quotes, comments, NUL bytes
Inputs: path (required), dry_run, create_backup.
cc_fix_umlautsFix UmlautsAIdempotent
Repairs broken German umlauts in source code files.
Args:
path (string): Path to the file
dry_run (boolean): Preview only
create_backup (boolean): Create backup
Detects 70+ patterns of broken umlauts and replaces them correctly.
Inputs: path (required), dry_run, create_backup.
cc_generate_licensesGenerate LicensesBIdempotent
Generates a third-party license file for an npm or Python project.
Args:
project_dir (string): Project directory
output_path (string): Output file
format (string): "text" | "json" | "csv"
Reads package.json (npm) or pip packages and collects license info.
Inputs: output_path (required), project_dir (required), format.
cc_generate_python_codeGenerate Python CodeCRead-onlyIdempotent
Generiert Python-Code-Snippets aus BACH-abgeleiteten Templates ohne Dateien zu schreiben
Inputs: act, base, body, kind, +15 more.
cc_get_languageA
Get the currently configured output language and supported languages for CodeCommander tools
Inputs: no named parameters.
cc_md_to_htmlMarkdown to HTMLBIdempotent
Converts Markdown to formatted HTML (printable as PDF).
Args:
input_path (string): Path to the Markdown file
output_path (string): Path to the HTML output
title (string, optional): Document title
Produces standalone HTML with CSS styling, printable as PDF via browser.
Inputs: input_path (required), output_path (required), title.
cc_md_to_pdfMarkdown to PDFAIdempotent
Converts Markdown to PDF using a headless browser (Edge/Chrome).
Args:
input_path (string): Path to the Markdown file
output_path (string): Path to the PDF output
title (string, optional): Document title
Uses the same Markdown parser as cc_md_to_html. Requires Edge or Chrome. Falls back to HTML if no browser is found.
Inputs: input_path (required), output_path (required), title.
cc_organize_importsOrganize ImportsAIdempotent
Organizes Python imports per PEP 8: sorted, deduplicated, grouped.
Args:
path (string): Path to the Python file
dry_run (boolean): Preview only
Groups: 1) future 2) stdlib 3) third-party 4) local
Inputs: path (required), dry_run.
cc_python_structural_editPython Structural EditC
Prüft und wendet BACH-abgeleitete strukturelle Python-Edits mit Vorschau, Testdatei und Backup-Schutz an
Inputs: path (required), operation (required), line, mode, +11 more.
cc_regex_testRegex TesterCRead-onlyIdempotent
Testet reguläre Ausdrücke gegen Text oder Dateiinhalt
Inputs: pattern (required), text, flags, file_path, +1 more.
cc_runtime_import_diagnoseRuntime Import DiagnoseCRead-only
Führt BACH-abgeleitete Python-Runtime-Importdiagnosen in isolierten Subprozessen aus
Inputs: path (required), modules, max_modules, python_path, +1 more.
cc_scan_emojiScan EmojiBRead-onlyIdempotent
Scans files for emojis and shows ASCII alternatives.
Args:
path (string): Path to the file or directory
recursive (boolean): Scan recursively
extensions (string): Only certain extensions
Useful for systems that don't support Unicode/Emoji.
Inputs: path (required), recursive, extensions.
cc_set_languageB
Set the output language for CodeCommander tools
Inputs: language (required).
cc_validate_jsonValidate JSONARead-onlyIdempotent
Validates JSON with detailed error information and position.
Args:
path (string): Path to the JSON file
Inputs: path (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 23 tools
Several clusters overlap: cc_fix_encoding, cc_fix_umlauts, cc_cleanup_file and cc_fix_json all repair file-level defects (BOM, NUL bytes appear in both fix_json and cleanup_file), and cc_analyze_code vs cc_analyze_methods / cc_extract_classes are nested views of the same file. Import handling is split across three tools (organize, diagnose, runtime_diagnose) that an agent could easily misselect. Descriptions help somewhat, but boundaries are blurry in the repair and analysis families.
All 23 names use a uniform cc_ prefix and snake_case, with mostly verb_noun form (fix_json, analyze_code, organize_imports, validate_json). A few deviate slightly toward noun_verb (cc_regex_test, cc_diff_files) but remain readable and predictable. The only inconsistency is that some descriptions are in German while names stay English.
23 tools sits in the heavy range for what is essentially a file-maintenance utility belt. Each tool has a specialty, but several niche ones (fix_umlauts, scan_emoji, check_indentation) arguably belong as options of broader repair/analysis tools rather than first-class endpoints.
Coverage across JSON repair/validation, code analysis, import hygiene, format conversion, encoding repair, and Markdown-to-HTML/PDF is broad with few dead ends. Gaps exist: no generic file read/write, formatting tools only cover Python imports (not JS/TS), code generation is Python-only, and convert_format supports YAML/TOML/XML but has no validate/repair counterparts for those formats.
Maintenance
Related MCP Connectors
238+ dev tools via MCP: JSON, QR, PDF, DNS, hash, UUID, code review, JWT, SSL, WHOIS, and more
Remote MCP for JSON repair, hashing, formatting, IDs, dates, units, and other small tools.
One MCP server for all your MCP servers: code mode, per-tool permissions, approvals and audit.
Remote MCP: JSON repair, JSON Schema validation, JSON to TypeScript, CSV to JSON and JSON to CSV.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceA modular MCP server that provides tools for file operations, regex-based code searching, and structural analysis of functions and classes across multiple programming languages. It also includes AI-powered features for intelligently updating files according to architectural changes.-
- FlicenseAqualityDmaintenanceA lightweight MCP server providing everyday developer utilities such as JSON formatting, UUID generation, Base64 conversion, HTTP status lookup, and Unix timestamp conversion as tools and resources.5-
- AlicenseBqualityDmaintenanceMCP server providing 37 developer tools for hashing, encoding, regex, JSON, SQL, cron, QR codes, UUID, JWT, and more, all powered by bmobot.ai APIs.37MIT
- AlicenseNot gradedqualityCmaintenanceA unified developer toolbox MCP server providing utilities for base64, JWT, timestamps, UUID, JSON formatting, hashing, URL handling, case conversion, color conversion, number bases, string operations, and regex.5 npmMIT