CodeCommander MCP
ellmos-ai/ellmos-codecommander-mcp
17 ferramentas de inteligência de código para análise, reparo e conversão
Ver no GitHubServidor MCP com 17 ferramentas para análise de código, reparo de JSON, organização de imports, conversão de formatos e testes de regex. Implementa AST parsing para Python, reparo automático de encoding/Mojibake e exportação de Markdown para HTML/PDF, complementando operações de filesystem.
Instalação
npx convez-ai ellmos-ai/ellmos-codecommander-mcp1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Análise de complexidade e estrutura de código Python
- Reparo automático de JSON malformado e problemas de encoding
- Organização e deduplica de imports seguindo PEP 8
- Conversão entre formatos (JSON, CSV, YAML, TOML, XML)
- Testes de expressões regulares com preview de substituição
- Exportação de Markdown para HTML/PDF com tabelas e code blocks
Veredito

MCP server robusto e bem documentado com foco em automação de tarefas de código. Excelente complemento ao FileCommander, coberto por testes e pronto para produção via npm. Recomendado para desenvolvedores que trabalham com análise e transformação programática de código.
README
A tradução para o português deste README ainda está na fila.
ellmos CodeCommander MCP Server
Part of the ellmos-ai family.
A developer-focused Model Context Protocol (MCP) server that gives AI assistants code analysis, JSON repair, encoding fix, import organization, format conversion, file diff, and regex testing capabilities.
17 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.
Why CodeCommander?
While FileCommander handles filesystem operations, CodeCommander focuses on code intelligence:
- Python Code Analysis - AST-based class/method extraction, complexity metrics, import analysis
- JSON Repair - Fix broken JSON automatically (trailing commas, single quotes, BOM, comments)
- Import Organization - Sort and deduplicate Python imports per PEP 8
- Encoding Fix - Repair Mojibake and double-encoded UTF-8 (27+ patterns)
- Umlaut Repair - Fix broken German characters (70+ patterns)
- Format Conversion - Convert between JSON, CSV, INI, YAML, TOML, XML, and TOON
- File Diff - Compare two files with unified diff output (LCS algorithm)
- Regex Tester - Test regular expressions with match details, groups, and replace preview
- Markdown Export - Convert Markdown to professional HTML/PDF with code blocks, tables, nested lists, blockquotes
- Cross-platform - Works on Windows, macOS, and Linux
Installation
Prerequisites
- Node.js 18 or higher
Option 1: Install from NPM
npm install -g ellmos-codecommander-mcp
Option 2: Install from Source
git clone https://github.com/ellmos-ai/ellmos-codecommander-mcp.git
cd ellmos-codecommander-mcp
npm install
npm run build
Configuration
Claude Desktop
Add to your claude_desktop_config.json:
Windows: %APPDATA%\Claude\claude_desktop_config.json
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
If installed globally via NPM:
{
"mcpServers": {
"codecommander": {
"command": "ellmos-codecommander"
}
}
}
If installed from source:
{
"mcpServers": {
"codecommander": {
"command": "node",
"args": ["/absolute/path/to/ellmos-codecommander-mcp/dist/index.js"]
}
}
}
Using Both Servers Together
FileCommander and CodeCommander are designed to work side by side:
{
"mcpServers": {
"filecommander": {
"command": "ellmos-filecommander"
},
"codecommander": {
"command": "ellmos-codecommander"
}
}
}
Tools Overview
Code Analysis (3 tools)
| Tool | Description |
|---|---|
cc_analyze_code | Full code analysis: classes, functions, imports, LOC, complexity |
cc_analyze_methods | Detailed method analysis: params, decorators, visibility, data flow |
cc_extract_classes | Extract Python classes/functions as separate text blocks |
Import Management (2 tools)
| Tool | Description |
|---|---|
cc_organize_imports | Sort & deduplicate Python imports per PEP 8 |
cc_diagnose_imports | Detect unused imports, duplicates, circular import risks |
JSON Tools (2 tools)
| Tool | Description |
|---|---|
cc_fix_json | Repair broken JSON (BOM, trailing commas, comments, single quotes) |
cc_validate_json | Validate JSON with detailed error position and context |
Encoding & Text (3 tools)
| Tool | Description |
|---|---|
cc_fix_encoding | Fix Mojibake / double-encoded UTF-8 (27+ patterns) |
cc_cleanup_file | Remove BOM, NUL bytes, trailing whitespace, normalize line endings |
cc_fix_umlauts | Repair broken German umlauts (70+ patterns, HTML entities, escapes) |
Scanning (1 tool)
| Tool | Description |
|---|---|
cc_scan_emoji | Scan files for emojis with codepoint info |
Format & Documentation (2 tools)
| Tool | Description |
|---|---|
cc_convert_format | Convert between JSON, CSV, INI, YAML, TOML, XML, and TOON formats |
cc_generate_licenses | Generate third-party license file (npm/pip) |
Developer Utilities (2 tools)
| Tool | Description |
|---|---|
cc_diff_files | Compare two files with unified diff output (configurable context lines) |
cc_regex_test | Test regex patterns against text/files with match details, groups, and replace preview |
Export (2 tools)
| Tool | Description |
|---|---|
cc_md_to_html | Markdown to standalone HTML with CSS styling (headers, code blocks, tables, nested lists, blockquotes, images, checkboxes) |
cc_md_to_pdf | Markdown to PDF via headless browser (Edge/Chrome). Falls back to HTML if no browser is available |
Total: 17 tools
Shared Tools
7 tools exist in both FileCommander and CodeCommander for convenience:
| FileCommander | CodeCommander | Function |
|---|---|---|
fc_fix_json | cc_fix_json | JSON repair |
fc_validate_json | cc_validate_json | JSON validation |
fc_fix_encoding | cc_fix_encoding | Encoding repair |
fc_cleanup_file | cc_cleanup_file | File cleanup |
fc_convert_format | cc_convert_format | Format conversion (JSON/CSV/INI/YAML/TOML/XML/TOON) |
fc_md_to_html | cc_md_to_html | Markdown to HTML export |
fc_md_to_pdf | cc_md_to_pdf | Markdown to PDF export |
Tool Prefix
All tools use the cc_ prefix (CodeCommander) to avoid conflicts with FileCommander's fc_ prefix and other MCP servers.
Security
See SECURITY.md for detailed security information.
Key points:
- All file-modifying tools support
dry_runmode - Backup creation is enabled by default for destructive operations
- No built-in sandboxing - security is delegated to the MCP client
- Designed for local development use via stdio transport
Development
npm install
npm run dev # Watch mode
npm run build # One-time build
npm start # Start server
npm test # Run test suite (vitest)
Testing
The project includes a comprehensive test suite with 139 tests covering all 17 tools.
npm test # Run all tests
npx vitest run # Same as above
npx vitest --watch # Watch mode
Tests are verified on Windows, macOS, and Linux.
GitHub Actions runs the build, Vitest suite, and npm package check on Node.js 20, 22, and 24.
Changelog
See CHANGELOG.md for the full version history.
License
MIT - Lukas Geiger (ellmos-ai)
History
This project was originally developed as BACH CodeCommander (bach-codecommander-mcp). It has been renamed to ellmos CodeCommander (ellmos-codecommander-mcp) as part of the ellmos-ai organization.
The legacy package name bach-codecommander-mcp is deprecated. Please use ellmos-codecommander-mcp instead:
npm uninstall -g bach-codecommander-mcp
npm install -g ellmos-codecommander-mcp
ellmos-ai Ecosystem
This MCP server is part of the ellmos-ai ecosystem — AI infrastructure, MCP servers, and intelligent tools.
MCP Server Family
| Server | Tools | Focus | npm |
|---|---|---|---|
| FileCommander | 44 | Filesystem, process management, interactive sessions | ellmos-filecommander-mcp |
| CodeCommander | 17 | Code analysis, AST parsing, import management | ellmos-codecommander-mcp |
| Clatcher | 12 | File repair, format conversion, batch operations | ellmos-clatcher-mcp |
| n8n Manager | 18 | n8n workflow management via AI assistants | n8n-manager-mcp |
| ControlCenter | 10 | MCP stack discovery, profile management, control plane | ellmos-controlcenter-mcp |
AI Infrastructure
| Project | Description |
|---|---|
| BACH | Text-based OS for LLMs — 113+ handlers, 550+ tools, 1870+ skills |
| clutch | Provider-neutral LLM orchestration with auto-routing and budget tracking |
| rinnsal | Lightweight agent memory, connectors, and automation infrastructure |
| ellmos-stack | Self-hosted AI research stack (Ollama + n8n + Rinnsal + KnowledgeDigest) |
| MarbleRun | Autonomous agent chain framework for Claude Code |
| gardener | Minimalist database-driven LLM OS prototype (4 functions, 1 table) |
| ellmos-tests | Testing framework for LLM operating systems (7 dimensions) |
Desktop Software
Our partner organization open-bricks bundles AI-native desktop applications — a modern, open-source software suite built for the age of AI. Categories include file management, document tools, developer utilities, and more.
Liability
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.
This project is an unpaid open-source donation under German law. Liability is limited to intent and gross negligence (§ 521 German Civil Code), supplemented by the MIT License warranty disclaimer. Use at your own risk.