convez.ai
MCP ServerDesenvolvimento WebIntermediário
ellmos-ai

CodeCommander MCP

ellmos-ai/ellmos-codecommander-mcp

17 ferramentas de inteligência de código para análise, reparo e conversão

Ver no GitHub
BomPluginScore · de 0 a 100

Servidor 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-mcp

1 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

Estrelas
4
Forks
0
Acompanhando
0
Saúde
87%
Último commit
há 6 dias
Versão
v1.3.27
Issues abertas
1
Contribuidores
2

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

🇩🇪 Deutsche Version

Part of the ellmos-ai family.

License: MIT npm version CodeCommander tests Node.js

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

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)

ToolDescription
cc_analyze_codeFull code analysis: classes, functions, imports, LOC, complexity
cc_analyze_methodsDetailed method analysis: params, decorators, visibility, data flow
cc_extract_classesExtract Python classes/functions as separate text blocks

Import Management (2 tools)

ToolDescription
cc_organize_importsSort & deduplicate Python imports per PEP 8
cc_diagnose_importsDetect unused imports, duplicates, circular import risks

JSON Tools (2 tools)

ToolDescription
cc_fix_jsonRepair broken JSON (BOM, trailing commas, comments, single quotes)
cc_validate_jsonValidate JSON with detailed error position and context

Encoding & Text (3 tools)

ToolDescription
cc_fix_encodingFix Mojibake / double-encoded UTF-8 (27+ patterns)
cc_cleanup_fileRemove BOM, NUL bytes, trailing whitespace, normalize line endings
cc_fix_umlautsRepair broken German umlauts (70+ patterns, HTML entities, escapes)

Scanning (1 tool)

ToolDescription
cc_scan_emojiScan files for emojis with codepoint info

Format & Documentation (2 tools)

ToolDescription
cc_convert_formatConvert between JSON, CSV, INI, YAML, TOML, XML, and TOON formats
cc_generate_licensesGenerate third-party license file (npm/pip)

Developer Utilities (2 tools)

ToolDescription
cc_diff_filesCompare two files with unified diff output (configurable context lines)
cc_regex_testTest regex patterns against text/files with match details, groups, and replace preview

Export (2 tools)

ToolDescription
cc_md_to_htmlMarkdown to standalone HTML with CSS styling (headers, code blocks, tables, nested lists, blockquotes, images, checkboxes)
cc_md_to_pdfMarkdown 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:

FileCommanderCodeCommanderFunction
fc_fix_jsoncc_fix_jsonJSON repair
fc_validate_jsoncc_validate_jsonJSON validation
fc_fix_encodingcc_fix_encodingEncoding repair
fc_cleanup_filecc_cleanup_fileFile cleanup
fc_convert_formatcc_convert_formatFormat conversion (JSON/CSV/INI/YAML/TOML/XML/TOON)
fc_md_to_htmlcc_md_to_htmlMarkdown to HTML export
fc_md_to_pdfcc_md_to_pdfMarkdown 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_run mode
  • 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

ServerToolsFocusnpm
FileCommander44Filesystem, process management, interactive sessionsellmos-filecommander-mcp
CodeCommander17Code analysis, AST parsing, import managementellmos-codecommander-mcp
Clatcher12File repair, format conversion, batch operationsellmos-clatcher-mcp
n8n Manager18n8n workflow management via AI assistantsn8n-manager-mcp
ControlCenter10MCP stack discovery, profile management, control planeellmos-controlcenter-mcp

AI Infrastructure

ProjectDescription
BACHText-based OS for LLMs — 113+ handlers, 550+ tools, 1870+ skills
clutchProvider-neutral LLM orchestration with auto-routing and budget tracking
rinnsalLightweight agent memory, connectors, and automation infrastructure
ellmos-stackSelf-hosted AI research stack (Ollama + n8n + Rinnsal + KnowledgeDigest)
MarbleRunAutonomous agent chain framework for Claude Code
gardenerMinimalist database-driven LLM OS prototype (4 functions, 1 table)
ellmos-testsTesting 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.

Ver o original no GitHub

Bom para

Relacionados