johnhuang316/code-index-mcp

解決的問題

Code Index MCP 解決了 AI 助手在理解與導航複雜多語言程式碼庫時的困難。它為 LLM 提供了一種結構化的方式，無需手動閱讀每一個檔案，即可對程式碼符號與檔案結構進行索引、搜尋與分析。

工作原理

它作為 Model Context Protocol (MCP) 伺服器運作，連結 AI 模型與本地檔案系統。採用雙策略索引架構：

• Tree-sitter AST 解析：為 10 種核心語言（包括 Python、TS、Rust 和 Go）提供深度原生語法解析，提取類別、方法與呼叫關係。
• 降階策略：為超過 50 種其他檔案類型提供基本索引。

伺服器內建檔案監視器，可實時更新索引，並與 ripgrep 或 ugrep 等原生搜尋工具整合，支援高階正規表示式與模糊搜尋。

適用對象

本工具專為使用 MCP 相容 AI 助手（如 Claude Desktop）的開發者設計，適用於需要協助進行程式碼審查、重構、除錯與大型專案架構分析的場景。

主要亮點

• 多語言支援：對 10 種語言提供專用 AST 解析，對 50+ 種檔案類型提供基本支援。
• 即時監控：透過原生作業系統檔案監視器實現自動索引更新。
• 深度分析：透過深度索引生成符號層級的元資料與複雜度指標。
• 彈性搜尋：支援字面量、正規表示式與模糊比對，結果支援分頁。
• 持久快取：將索引本地儲存，實現後續存取的快速載入。