このプロジェクトについて

jCodeMunch MCPは、コード探索時のAIトークン消費を削減するために設計されたModel Context Protocol（MCP）サーバーです。tree-sitterを使用してソースコードを解析し、シンボル（関数、クラス、メソッド、定数）のローカルインデックスをバイトレベルのオフセット付きで作成することで、エージェントはファイル全体を読む代わりに必要なコードだけを正確に取得できます。 主な機能は以下の通りです： - シンボル単位の取得：`get_symbol_source`は正確な関数本体を返し、`search_symbols`は名前でシンボルを検索し、`get_file_outline`は構造的な概要を提供します。 - 構造的クエリ：`find_importers`、`get_blast_radius`、`get_call_hierarchy`、`find_dead_code`、`get_changed_symbols`、`get_hotspots`、およびASTベースのアンチパターン検索。 - タスクコンテキストの組み立て：`assemble_task_context`はタスクの意図を分類し、トークン予算内で適切なツールシーケンスを実行します。 - 安全性チェック：`check_edit_safe`、`check_delete_safe`、`get_pr_risk_profile`、編集可能なブロックを伴う`plan_refactoring`、さらに型チェッカーの診断（mypy、pyright、tsc、ruff）との統合。 - 信頼度スコア、鮮度フラグ、カバレッジ契約、シークレットの秘匿化、SCIPベースのコンパイラ検証済み参照。 - ウォッチモード、エージェントフック、VS Code拡張機能によるインデックスの自動鮮度維持。 ベンチマークでは、3つの公開リポジトリにおいてgrep-and-readベースラインと比較してトークンが28.3倍削減（96.5%節約）され、リポジトリごとの節約率は15.6倍から39.7倍に及ぶと主張されています。本番環境のVue 3コードベースでの独立したA/Bテストでは、ツール層で15～25%の節約と成功率の向上が報告されています。 インストールは`uv tool install jcodemunch-mcp`または`uvx jcodemunch-mcp`で行い、`init`コマンドがMCPクライアントを自動設定し、CLAUDE.mdプロンプトポリシーをインストールします。tree-sitterによる70以上の言語、モノレポ、増分インデックスをサポートします。ローカルファースト設計で、インデックスは`~/.code-index/`に保存されます。オプションの匿名節約カウンター（オプトアウト可能）があります。 ライセンスはデュアルユースです：個人利用は無料、収益を生む用途には商用ライセンスが必要です。