jcodemunch-mcp
AI 代理的符號層級程式碼檢索:只擷取你需要的函式,而非整個檔案。本機執行。在我們的 15 次查詢基準測試中,平均每次查詢比 grep 加讀取方式減少 96.2% 的 token。
jcodemunch-mcp 是什麼?
AI 代理的符號層級程式碼檢索:只擷取你需要的函式,而非整個檔案。本機執行。在我們的 15 次查詢基準測試中,平均每次查詢比 grep 加讀取方式減少 96.2% 的 token。可與 Claude Code、Cursor、Codex 及任何 MCP 用戶端搭配使用。非商業用途免費;商業用途需一次性授權。
jcodemunch-mcp 概覽
這是什麼
jCodeMunch MCP 是一個模型上下文協定(MCP)伺服器,透過 tree-sitter AST 解析從 GitHub 儲存庫中精確擷取原始碼。它會對程式碼庫建立一次索引,讓 AI 代理只擷取所需的確切程式碼——函式、類別、方法、常數、大綱以及緊密範圍的上下文套件——而不是反覆讀取整個檔案。該專案報告已節省 838B+ 個 token、136,000+ 個回報安裝、避免 $4.2M+ 的 AI 支出,以及防止 100,000+ 公斤的 CO₂ 排放(數據截至 2026-08-17,以 Claude Opus 輸入費率 $5/MTok 計算)。它可與 Claude Code、Cursor、VS Code、Codex CLI、Windsurf、Continue 及任何相容 MCP 的用戶端搭配使用。
主要功能
- 符號層級擷取:搜尋符號並以位元組級精確度擷取確切實作。
- Tree-sitter AST 解析:將原始碼索引為結構化的符號元資料(簽名、種類、完整名稱、摘要、位元組偏移量)。
- Token 效率:在三個公開儲存庫的基準測試中,比 grep-and-read 代理減少 28.9 倍的 token(減少 96.5%)。
- 結構化查詢:包含
get_blast_radius、find_importers、get_class_hierarchy和find_dead_code等原生工具無法回答的工具。 - 緊湊的 MUNCH 線路編碼:從回應中中位數減少 45.5% 的位元組。
- 一鍵安裝與初始化:
uv tool install jcodemunch-mcp然後jcodemunch-mcp init會自動偵測 MCP 用戶端並寫入設定項目。
使用情境
- 尋找函式:搜尋符號,擷取確切實作,而不是開啟並掃描大型檔案。
- 理解模組:只拉取相關的符號和匯入,而不是讀取廣泛的檔案區域。
- 探索儲存庫結構:查詢大綱、樹狀結構和目標套件,而不是逐個遍歷檔案。
- 影響分析:使用
get_blast_radius來判斷變更某個項目會破壞哪些內容。 - 孤立檔案偵測:使用
find_importers來偵測未被任何地方匯入的檔案。
快速開始
bashuv tool install jcodemunch-mcpjcodemunch-mcp init驗證:bashjcodemunch-mcp --version手動 Claude Code 設定:bashclaude mcp add -s user jcodemunch -- uvx jcodemunch-mcp然後在 CLAUDE.md 中加入:markdownCall the jcodemunch_guide tool and strictly follow its instructions.
授權與價格
授權條款在元資料中未標明(NOASSERTION)。README 中說明:「個人使用免費。用它來賺錢,J 叔叔就要抽成。這樣公平吧?商業授權如下。我們的保證:如果 jCodeMunch 沒有為自己賺回成本,你就不用付 jCodeMunch 的錢。」具體商業授權條款請參閱儲存庫 README。
內容整理自該專案公開的 README 與儲存庫資訊。