BACH CodeCommander

ローカル

github.com開発ツール41 週間前に更新

リポジトリ公式サイト

BACH CodeCommander について

BACH CodeCommander は、コーディングエージェントや開発者向けに、コード分析とファイル編集・修復・変換を提供する MCP サーバーです。プレビュー可能な Python 構造編集、文字コード修復、フォーマット変換が特徴です。

主な機能

01Python・JavaScript・TypeScript のコード分析
02Python 構造編集のプレビューと差分生成
03JSON 修復と Python インポート整理
04文字コードと文字化けの修復
057 種類のデータ形式の変換
06ファイル比較と正規表現テスト

活用シーン

01コード構造と複雑度の調査
02適用前の Python 編集プレビュー
03不正な設定ファイルの修復
04異なる形式間でのデータファイル変換

MCP 対応

コード分析、Python 編集、JSON 修復、文字コード修復、形式変換、差分比較、正規表現テストなどの開発ツールを MCP 経由で提供します。README では stdio JSON-RPC クライアントについて説明しています。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定

{
  "mcpServers": {
    "lukisch-bach-codecommander": {
      "command": "npx",
      "args": [
        "-y",
        "bach-codecommander-mcp"
      ]
    }
  }
}

起動コマンドnpx -y bach-codecommander-mcp

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ

npmbach-codecommander-mcp1.3.0stdio

ツール

掲載時のツール一覧 · 3 週間前に更新

パラメーター	型	必須	説明
path	string	はい	Pythonファイルのパス

詳細

ellmos CodeCommander MCP サーバー

🇩🇪 ドイツ語版

ellmos-ai ファミリーの一員です。

メモ

AI アシスタントおよび LLM 向け： このリポジトリの機械可読なインデックス作成ドキュメントは llms.txt にあります。このサーバーは、cc_ プレフィックスが付いた23個の専門ツールを公開しています。

開発者向けの Model Context Protocol（MCP）サーバーです。AI アシスタントに、コード解析、Python の構造的な編集、JSON の修復、エンコーディングの修正、インポートの整理、形式変換、ファイルの差分確認、正規表現のテスト機能を提供します。

開発者向けに最適化された23個のツールを備えた、FileCommander のコーディングパートナーです。

見つけやすさ： npm に ellmos-codecommander-mcp として公開され、Glama で確認できます。また、io.github.ellmos-ai/ellmos-codecommander-mcp の server.json により、公式 MCP Registry への登録準備が整っています。レジストリおよびディレクトリのマニフェストである server.json、glama.json、smithery.yaml、llms.txt は、すべて完全に整合した状態で管理されています。

クイックナビゲーション

概要と主な特長
対象ユーザーと見つけやすさ
代替製品との比較表
アーキテクチャとシステム概要
安全な構造編集のライフサイクル
ガバナンスとランタイム不変条件
開発者向けツールスイート（23 ツール）
FileCommander と共有するツール
インストールとクイックスタート
設定と MCP クライアントのセットアップ
多言語サポート（i18n）
開発と品質保証
関連エコシステムとパートナーマトリクス
サードパーティライセンスと透明性
セキュリティポリシーと対応 SLA
変更履歴とバージョン履歴
ライセンスと法的帰属
法定告知、責任制限、SLA（§ 521 BGB）

1. 概要と主な特長

FileCommander がファイルシステム操作とシステムプロセスを担当するのに対し、CodeCommander はコードインテリジェンスと開発者の精密さに特化しています。

Python、JavaScript、TypeScript の解析 — 拡張子に応じたクラス、メソッド、関数、複雑度メトリクス、インポートの解析。JS/TS の解析は正規表現ベースで、読み取り専用です。
BACH 由来の Python ヘルパー — ランタイムのインポート診断、構造編集、インデントチェック、テンプレートベースのコード生成。
明示的な言語ゲート — Python 専用のパスツールは、Python 形式の誤った検出結果を生成するのではなく、.py 以外のファイルを明示的に拒否します。
JSON の修復と検証 — 末尾のカンマ、シングルクォート、BOM、コメントなどが原因で壊れた JSON を、正確なエラー位置とともに自動修復します。
PEP 8 に準拠したインポートの整理 — PEP 8 のガイドラインに従って、Python のインポートを並べ替えて重複を削除します。
エンコーディングと文字化けの修復 — 文字化けや UTF-8 の二重エンコード（27 種類以上のパターン）、およびドイツ語の文字の破損（ウムラウトのパターン 70 種類以上）を修復します。
汎用フォーマット変換 — JSON、CSV、INI、YAML、TOML、XML、TOON の各形式を相互にロスレス変換します。
統合ファイル差分 — LCS 統合差分形式の出力と設定可能なコンテキスト行数で、2 つのファイルを比較します。
正規表現テストワークベンチ — 一致の詳細、キャプチャグループ、置換プレビューを使って正規表現をテストします。
Markdown エクスポート — Markdown を、構文スタイル付きコードブロック、表、引用を含む単体の HTML または PDF に変換します。
クロスプラットフォーム対応 — Windows、macOS、Linux を完全にサポートします。

2. 対象ユーザーと見つけやすさ

CodeCommander MCP は、最新の自律型 AI コーディング、ローカルのマルチエージェントスウォーム、安全性に準拠した開発者向けツールにおける主要なボトルネックに対処できるよう設計されています。

対象ユーザーとステークホルダーのペルソナ

[PERSONA-01]（[PERSONA-1]）自律型 AI コーディングエージェントと LLM ペアプログラマー
- プロフィール： Claude Code、Antigravity、Codex、Cursor、Windsurf など、自動コードリファクタリング、テスト修復、機能開発を行うエージェントです。
- 課題： LLM が標準的に生成するコードでは、存在しないインポート、複雑な Python の制御フローにおけるインデントの崩れ、無効な JSON 設定、単純なチャンク編集時の構文破損が頻繁に発生します。
- 解決策： ネイティブ AST 抽出（cc_extract_classes、cc_analyze_methods）、統合差分によるプレビュー対応の構造編集（cc_python_structural_edit）、自動インデントチェック（cc_check_indentation）、決定論的な JSON 修復（cc_fix_json）を提供します。
[PERSONA-02]（[PERSONA-2]）フルスタックおよび Python／TypeScript のソフトウェアエンジニア
- プロフィール： 複数の言語が混在するプロジェクト、CLI ユーティリティ、クロスランゲージ AST 分析や設定形式の迅速な変換を必要とするデータパイプラインを保守する開発者です。
- 課題： 手間のかかる形式の手動変換（JSON ↔ YAML ↔ TOML ↔ TOON ↔ XML）、レガシーエンコーディングによるドイツ語ウムラウトの破損や文字化け、循環するランタイムインポートが課題です。
- 解決策： 汎用形式コンバーター（cc_convert_format）、非破壊的なエンコーディングおよびウムラウトの修復（cc_fix_encoding、cc_fix_umlauts）、分離されたランタイムインポート診断（cc_runtime_import_diagnose）、インタラクティブな正規表現テスター（cc_regex_test）を提供します。
[PERSONA-03]（[PERSONA-3]）エンタープライズ AI セーフティ、SecOps、コードガバナンス担当者
- プロフィール： 開発者のワークステーションや CI/CD ランナーで使用する MCP ツールチェーンを評価する、セキュリティ監査担当者、コンプライアンスエンジニア、エンタープライズアーキテクトです。
- 課題： クラウドテレメトリーによる機密コードの漏えい、許可されていないプロセスの権限昇格、AI アシスタントによるファイルの破壊的な上書きのリスクがあります。
- 解決策： 100％のゼロエグレスを実現するローカル stdio トランスポート（INV-LOCAL-01）、非特権のユーザー空間での実行（INV-SEC-02）、変更前のタイムスタンプ付き .bak バックアップの必須作成（INV-BAK-04）、ドライラン差分プレビューによる安全性確保（INV-PREV-03）、分離されたサブプロセスのタイムアウト（INV-ISOL-05）を提供します。
[PERSONA-04]（[PERSONA-4]）オープンソースエコシステムのアーキテクトと MCP ツール開発者
- プロフィール： Glama、Smithery、npm、GitHub で MCP サーバーを構築、公開、インデックス化するメンテナーです。
- 課題： ディレクトリのマニフェストが断片化していること、サードパーティライセンスの開示が欠けていること、AI エージェント向けの機械可読なインデックス情報がないことが課題です。
- 解決策： 自動コントラクトテストと完全なオープンソースライセンス監査（THIRD_PARTY_LICENSES.md）によって検証される、package.json、server.json、glama.json、smithery.yaml、llms.txt 間の100％のマニフェスト整合性を提供します。

購買意欲の高い検索クエリ（SEO と見つけやすさ）

mcp code analysis server
model context protocol python ast tools
mcp server codecommander
python structural edit mcp
claude code developer mcp server
mcp json repair and encoding fix
local-first mcp tools for coding
mcp python runtime import diagnose
format converter mcp json yaml toml toon
offline code intelligence mcp server

3. 代替手段との比較表

次の表では、10 の重要な運用上の観点から、CodeCommander MCP と代替となる開発者向けツールのアプローチを比較します。

寸法／機能	汎用ファイル MCP	生のシェル／アドホックスクリプト	大規模クラウド LLMOps	従来型 IDE プラグイン	ellmos CodeCommander MCP
1. AST コードインテリジェンス	なし（生テキストの読み取り）	カスタムの python スクリプトが必要	クラウドパーサーが必要	組み込み（GUI のみ）	ネイティブ AST と正規表現 JS/TS（`cc_analyze_code`）
2. 安全な構造編集プレビュー	なし（無条件に上書き）	リスクが高い（`sed`/`awk`）	クラウドゲートウェイに依存	対話型ダイアログ	プレビュー対応の安全な差分（`mode: "preview"`）
3. 変更前のバックアップを必須化	なし	手動スクリプトが必要	なし	ローカル履歴（内容が不透明）	`.bak` を自動作成（`INV-BAK-04`）
4. 実行時インポート診断	なし	安全でない直接実行	なし	部分対応／静的解析のみ	分離されたサブプロセス＋タイムアウト（`INV-ISOL-05`）
5. 文字コードと文字化けの復元	なし	脆弱な `iconv` の呼び出し	なし	基本的な文字コード切り替え	27 種類以上の文字化け、70 種類以上のウムラウト（`cc_fix_encoding`）
6. 汎用フォーマット変換	なし	個別の CLI ツールが複数必要	SaaS 変換 API	複数プラグインの設定が必要	7 種類の形式をロスレス変換（`JSON/YAML/TOML/XML/TOON`）
7. 差分エンジンと正規表現ワークベンチ	なし	基本的な `diff`/`grep`	なし	GUI パネルのみ	LCS 統合差分とグループ／置換に対応した正規表現
8. ローカルファーストとゼロエグレス	ホストに依存	ローカル	クラウドへの送信／テレメトリ	多くの場合、クラウドに接続	100％オフラインの Stdio JSON-RPC（`INV-LOCAL-01`）
9. 多言語（i18n）対応	英語のみ	なし	英語のみ	言語パック	6 言語を動的に切り替え（`cc_set_language`）
10. レジストリとマニフェストの同等性	最小限	なし	独自仕様	マーケットプレイス固有	npm、Glama、Smithery、MCP Registry、`llms.txt`

4. アーキテクチャとシステム概要

+==============================================================================================================+
|                            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                  |
|  - Multi-Language Runtime (i18n): Dynamic Locale Selector [EN, DE, ES, ZH, JA, RU] (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 --> Export

5. 安全な構造編集のライフサイクル

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
    end

6. ガバナンスとランタイム不変条件

ellmos-codecommander-mcp は、すべてのプラットフォームにおいて、10 個の中核となるアーキテクチャおよびランタイム不変条件を保証します。

不変条件 ID	分類	アーキテクチャ上の保証と検証メカニズム
`INV-LOCAL-01`	外部通信ゼロのプライバシー	完全なローカル stdio JSON-RPC トランスポート。ネットワークテレメトリー、クラウドへのビーコン送信、リモートへのデータ送信は一切ありません。
`INV-SEC-02`	非特権セキュリティ	標準ユーザー空間で実行され（`RunAsInvoker`）、root 権限または管理者権限への昇格は不要です。
`INV-PREV-03`	プレビューの安全性	構造編集は、統一差分を生成する非変更のプレビューモード（`mode: "preview"`）がデフォルトです。
`INV-BAK-04`	自動バックアップ	ファイルを変更する前に、ディスク上のファイルを直接書き換える前に、タイムスタンプ付きの `.bak` ファイルを自動生成します。
`INV-ISOL-05`	サブプロセスの分離	Python ランタイムのインポート診断は、タイムアウトが設定された分離済みの子プロセスで実行されます。
`INV-GATE-06`	明示的な言語ゲート	Python 固有のパスツールは `.py` 以外のファイルを明示的に拒否します。JS/TS の解析は読み取り専用で、正規表現ベースです。
`INV-ENC-07`	非破壊的なエンコーディング処理	修復されたテキストは、データ損失やバイナリーの破損を起こすことなく、27 種類以上の文字化けパターンと 70 種類以上のドイツ語ウムラウトパターンを復元します。
`INV-FMT-08`	フォーマット相互変換の同等性	スキーマを保持したまま、JSON、CSV、INI、YAML、TOML、XML、TOON 間でロスレスに変換します。
`INV-I18N-09`	ランタイムの多言語対応	`cc_set_language` により、6 言語（EN、DE、ES、ZH、JA、RU）をランタイム中に動的に切り替えられます。
`INV-SLA-10`	48 時間のセキュリティ対応 SLA	Node 20、22、24 を使用した Ubuntu、Windows、macOS で検証済みです。48 時間以内の初回対応と 5 日以内のトリアージを公約しています。

7. 開発者向けツールスイート（23 ツール）

コード解析（3 ツール）

ツール	説明
`cc_analyze_code`	読み取り専用の Python または正規表現ベースの JavaScript/TypeScript 解析：クラス、関数、インポート、LOC、複雑度
`cc_analyze_methods`	読み取り専用の Python または正規表現ベースの JavaScript/TypeScript メソッド解析。Python では BACH ガードレールを維持します
`cc_extract_classes`	Python のクラス／関数を個別のテキストブロックとして抽出します。オプションで pycutter スタイルのインラインコンテンツを含められます

インポート管理（3 ツール）

ツール	説明
`cc_organize_imports`	PEP 8 に従って Python のインポートを並べ替え、重複を削除します
`cc_diagnose_imports`	読み取り専用の Python または正規表現ベースの JavaScript/TypeScript インポート診断
`cc_runtime_import_diagnose`	タイムアウトを設定して分離された Python ランタイムインポートを実行し、`__init__.py` の解析と循環インポートのヒントを提供します

JSON ツール（2 ツール）

ツール	説明
`cc_fix_json`	壊れた JSON を修復します（BOM、末尾のカンマ、コメント、シングルクォート）
`cc_validate_json`	詳細なエラー位置とコンテキストを示して JSON を検証します

エンコーディングとテキスト（3 ツール）

ツール	説明
`cc_fix_encoding`	文字化け／UTF-8 の二重エンコードを修正します（27 パターン以上）
`cc_cleanup_file`	BOM、NUL バイト、末尾の空白を削除し、改行コードを正規化します
`cc_fix_umlauts`	壊れたドイツ語のウムラウトを修復します（70 パターン以上、HTML エンティティ、エスケープ）

スキャン（1 ツール）

ツール	説明
`cc_scan_emoji`	コードポイント情報とともに、ファイル内の絵文字をスキャンします

フォーマットとドキュメント（2 ツール）

ツール	説明
`cc_convert_format`	JSON、CSV、INI、YAML、TOML、XML、TOON 形式間で変換します
`cc_generate_licenses`	サードパーティライセンスファイルを生成します（npm/pip）

開発者向けユーティリティ（2 ツール）

ツール	説明
`cc_diff_files`	2 つのファイルを統一差分形式で比較します（コンテキスト行数を設定可能）
`cc_regex_test`	テキスト／ファイルに対して正規表現パターンをテストし、一致の詳細、グループ、置換プレビューを表示します

Python 支援（3 tools）

Tool	Description
`cc_check_indentation`	コロンの欠落、インデントされていない return/yield 文、タブとスペースが混在したインデントを検出します
`cc_generate_python_code`	テンプレートから Python の関数、クラス、データクラス、CLI スタブ、テスト、例外、モジュールを生成します
`cc_python_structural_edit`	プレビュー、テストファイル、構文チェック、バックアップの各モードで、Python の構造的な編集を確認して適用します

エクスポート（2 tools）

Tool	Description
`cc_md_to_html`	CSS スタイル（ヘッダー、コードブロック、テーブル、入れ子のリスト、引用、画像、チェックボックス）を適用した、単独で動作する HTML への Markdown 変換
`cc_md_to_pdf`	ヘッドレスブラウザー（Edge/Chrome）を使用して Markdown を PDF に変換します。ブラウザーが利用できない場合は HTML にフォールバックします

ランタイム言語管理（2 tools）

Tool	Description
`cc_set_language`	アクティブなランタイム言語を切り替えます（`en`、`de`、`es`、`zh`、`ja`、`ru`）
`cc_get_language`	現在アクティブな言語と、対応するロケールコードを照会します

合計：23 個の開発者向けツールを cc_ プレフィックスで利用できます。

8. FileCommander との共有ツール

利便性のため、FileCommander と CodeCommander の両方に 7 個のツールが用意されています。

FileCommander	CodeCommander	機能
`fc_fix_json`	`cc_fix_json`	JSON の修復
`fc_validate_json`	`cc_validate_json`	JSON の検証
`fc_fix_encoding`	`cc_fix_encoding`	エンコーディングの修復
`fc_cleanup_file`	`cc_cleanup_file`	ファイルのクリーンアップ
`fc_convert_format`	`cc_convert_format`	フォーマット変換（JSON/CSV/INI/YAML/TOML/XML/TOON）
`fc_md_to_html`	`cc_md_to_html`	Markdown から HTML へのエクスポート
`fc_md_to_pdf`	`cc_md_to_pdf`	Markdown から PDF へのエクスポート

CodeCommander のすべてのツールでは cc_ プレフィックスを使用し、FileCommander の fc_ 名前空間とシームレスに共存できるようにしています。

9. インストールとクイックスタート

前提条件

Node.js 20 以降
npm 9 以降

オプション 1：NPM からインストール（推奨）

npm install -g ellmos-codecommander-mcp

オプション 2：ソースからインストール

git clone https://github.com/ellmos-ai/ellmos-codecommander-mcp.git
cd ellmos-codecommander-mcp
npm install
npm run build

10. 設定と MCP クライアントのセットアップ

Claude Desktop

claude_desktop_config.json に追加します。

Windows： %APPDATA%\Claude\claude_desktop_config.json
macOS： ~/Library/Application Support/Claude/claude_desktop_config.json

グローバル NPM インストール：

{
  "mcpServers": {
    "codecommander": {
      "command": "ellmos-codecommander"
    }
  }
}

ソースからビルド：

{
  "mcpServers": {
    "codecommander": {
      "command": "node",
      "args": ["/absolute/path/to/ellmos-codecommander-mcp/dist/index.js"]
    }
  }
}

FileCommander との共存

FileCommander と CodeCommander は同時に実行できるよう設計されています。

{
  "mcpServers": {
    "filecommander": {
      "command": "ellmos-filecommander"
    },
    "codecommander": {
      "command": "ellmos-codecommander"
    }
  }
}

11. 多言語サポート（i18n）

CodeCommander は、すべてのツールの説明、出力通知、診断メッセージで、6 言語をネイティブにサポートしています。

en — English（デフォルト）
de — Deutsch（ドイツ語）
es — Español（スペイン語）
zh — 简体中文（中国語・簡体字）
ja — 日本語
ru — Русский（ロシア語）

cc_get_language を使って現在の言語を確認するか、cc_set_language を使ってアクティブな MCP セッション中に言語を動的に変更できます。

12. 開発と品質保証

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)

テストゲートは意図的に分離されており、Node.js 20、22、24を使用して、Ubuntu、macOS、WindowsでCIにより自動実行されます（自動アサーションは合計302件で、すべて合格しています）。貢献のワークフローと開発ガイドラインについては、CONTRIBUTING.mdで詳しく説明しています。

13. 関連エコシステムとパートナーマトリックス

ローカルファーストツールファミリーの ellmos-ai および open-bricks の一部です。

MCP サーバーファミリー

サーバー	ツール	主な機能	npm
FileCommander	50	ファイルシステム、プロセス管理、対話型セッション、クラウドロックに安全な操作	`ellmos-filecommander-mcp`
CodeCommander	23	コード解析、AST編集、JSON修復、差分、正規表現	`ellmos-codecommander-mcp`
Clatcher	12	ファイル修復、フォーマット変換、バッチ処理	`ellmos-clatcher-mcp`
n8n Manager	19	AI アシスタントによるn8nワークフロー管理	`n8n-manager-mcp`
ControlCenter	34	MCPスタックの検出、プロファイル管理、コントロールプレーン	`ellmos-controlcenter-mcp`
Homebase	51	ローカルファーストのLLMメモリー、知識、状態、ルーティング、スウォームオーケストレーション	`ellmos-homebase-mcp`（アルファ）
ServerCommander	8	サーバー操作：ヘルスチェック、ログ解析、デプロイのドライラン、メール診断	`ellmos-servercommander-mcp`（アルファ）
Blender Use	4	ヘッドレスBlenderアセットの品質保証とFBX再インポート検証	`ellmos-blender-use-mcp`（アルファ）
Open Compute	16	モデルに依存しないコンピューター操作：キャプチャ、安全性ゲート付きアクション、Windows UIA	`open-compute-mcp`（アルファ）

同系列の開発者向け、ファイルおよびドキュメントツール

エコシステム	ツール／プロジェクト	主な用途と機能
ellmos-ai	sqlite-transit-sync	HMAC 検証に対応したオフラインでの SQLite 変更配布
ellmos-ai	policy-registry	AI エージェント向けの暗号学的に署名された委任ポリシー
ellmos-ai	clutch	自動ルーティングと予算追跡に対応した、プロバイダーに依存しない LLM オーケストレーション
ellmos-ai	BACH	LLM エージェント向けのローカルファーストなテキストベース OS — 113 以上のハンドラー、550 以上のツール
dev-bricks	DevCenter	PySide6 開発者向けデスクトップスイートとオフラインのシークレット保管庫
dev-bricks	CodeBox	高速なデスクトップ用コードスニペットマネージャーとローカル AST インデックス作成
dev-bricks	MethodenAnalyser	メソッドのフローと複雑さを診断するエンジン
dev-bricks	Zombie Killer Tray	孤立した MCP プロセスを確認するためのオプションの Windows ツール。CodeCommander は、サポート対象の `node_modules/ellmos-codecommander-mcp/dist/index.js` エントリポイントから起動する場合、設定済みの候補となります。追加のプロセスチェックと適用チェックもすべて適用されます
doc-bricks	PDFtoPDFocr	Tesseract を使って検索可能な PDF を作成するデスクトップ OCR パイプライン
doc-bricks	DokuReader	複数形式に対応したドキュメントワークスペースとオフライン PDF エクスポート
file-bricks	ProFiler	複数ペインのファイル管理と一括バッチ操作
open-bricks	open-bricks	AI ネイティブなデスクトップアプリケーションを提供する包括的な組織

14. サードパーティライセンスと透明性

このプロジェクトは、オープンソースの透明性を厳格に遵守しています。

実行時および開発時のすべての依存関係は、THIRD_PARTY_LICENSES.md と、そのプレーンテキスト版である THIRD_PARTY_LICENSES.txt で監査されています。
現在の本番依存関係の監査（npm audit --omit=dev --json、2026-09-20 に確認）では、脆弱性のあるパッケージノードが 5 件（高 3 件、中 2 件）報告されています。対応状況は TASKPLAN #2198 で追跡しています。
寛容なオープンソースライセンス（MIT、BSD-2-Clause、BSD-3-Clause、Apache-2.0）のみで配布されています。
見つけやすさ、ペルソナ、マーケティング指標の詳細は MARKETING-LOG.txt に記載されています。
独自のトラッキングはなく、テレメトリビーコンもなく、ウイルス性のあるコピーレフト依存関係もありません。

15. セキュリティポリシーと対応 SLA

脆弱性の完全な開示手順については、SECURITY.md をご確認ください。

外部送信ゼロの保証： stdio を介して完全にローカルで実行します。
プレビューとバックアップの安全性： 破壊的な操作では .bak バックアップを作成し、変更を加えないプレビューに対応しています。
非特権ユーザーモード： 標準の非特権ユーザー権限（RunAsInvoker）で実行します。
専用の対応窓口： [email protected] および [email protected] までご連絡ください。48 時間以内の初回応答 SLA と 5 日以内のトリアージ対応を保証します。

16. 変更履歴とバージョン履歴

リリースノートとバージョン履歴については、CHANGELOG.md をご覧ください。

17. ライセンスと法的帰属

open-bricks umbrella の帰属については NOTICE を、開発ガイドラインについては CONTRIBUTING.md を、Level 1 SBOM 不変条件のインベントリについては THIRD_PARTY_LICENSES.md / THIRD_PARTY_LICENSES.txt をご覧ください。

18. 法定通知、責任制限、SLA（§ 521 BGB）

このプロジェクトは、ドイツ民法第516条以降（好意に基づく無償提供）に基づく無償のオープンソース寄贈です。作成者および貢献者の責任は、ドイツ民法第521条に従い、故意および重過失に限定されます。これに加えて、MITライセンスの免責条項が適用されます。

利用は自己責任です。保守の約束、可用性の保証、エラーがないことや特定の目的への適合性の保証はありません。

セキュリティに関わるインシデントおよび脆弱性は、[email protected]、[email protected]、[email protected] 宛てに、拘束力のある48時間の SLAに基づいて受け付けられ、5営業日以内にトリアージされます。

このプロジェクトは、ドイツ法（ドイツ民法第516条以降）に基づく無償のオープンソース寄贈です。責任は故意および重過失に厳格に限定されます（ドイツ民法第521条）。MITライセンスの免責条項も適用されます。利用は自己責任です。保証、保守の保証、特定の目的への適合性の保証はありません。

セキュリティインシデントおよび脆弱性は、[email protected]、[email protected]、[email protected] を通じて、拘束力のある48時間の対応 SLAに基づいて取り扱われ、5営業日以内に正式なトリアージが行われます。

Markdown 対応

ログインしてコメント

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

入門ガイドを読む

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。