使用
Linux x86_64
需要先準備
- 執行環境:
python>=3.10,uv
uv tool install code-index-mcp(將 code-index-mcp 加入 PATH)
uv tool install code-index-mcp
加進你的 agent
claude mcp add code-index-mcp -- code-index-mcp --project-path '<project-path>'Claude Desktop、Cursor 等用戶端用的 JSON
{
"mcpServers": {
"code-index-mcp": {
"command": "code-index-mcp",
"args": [
"--project-path",
"<project-path>"
]
}
}
}請把 <project-path> 換成你自己的路徑。
在 AI 助理中將 code-index-mcp --project-path <your project> 加為 MCP 伺服器,或用 code-index-mcp --project-path <your project> --transport streamable-http --port <por 透過 HTTP 執行
它能做什麼
- 以 regex 與模糊比對搜尋程式碼已測試
怎麼使用
- 將助理連上
code-index-mcp --project-path <your project>。 - 呼叫
search_code_advanced工具,pattern填入如<your regex>,並將regex設為 true。
- 將助理連上
- 用 tree-sitter 解析 10 種語言的程式碼符號已測試
怎麼使用
- 啟動
code-index-mcp --project-path <your project> --transport streamable-http --port <port>,並將助理連上http://127.0.0.1:<port>/mcp。 - 呼叫
build_deep_index工具。 - 以
file_path和symbol_name呼叫get_symbol_body,查看該符號的程式碼。
- 啟動
- 摘要檔案的結構與複雜度已測試
怎麼使用
- 啟動
code-index-mcp --project-path <your project> --transport streamable-http --port <port>,並將助理連上http://127.0.0.1:<port>/mcp。 - 呼叫
build_deep_index工具。 - 以要摘要檔案的
file_path呼叫get_file_summary。
- 啟動
- 檔案變更時自動更新索引沒有看到它可用
pickfit 測到哪一步
Linux x86_64
- 可以安裝
- 可以連線
- 4 項功能中 3 項可用
- 可離線使用
適合用來
- 找出程式碼庫中所有使用舊 API 的地方
- 找出函式被呼叫的位置
- 除錯時搜尋錯誤處理程式碼
pickfit 怎麼測的
每次測試都從乾淨的機器開始,照上面的步驟執行。 pickfit 怎麼驗證
Linux x86_64
MCP 用戶端成功呼叫工具
- 從頭重跑
- 可離線使用
- 檢查於 2026年11月15日
MCP 用戶端透過 stdio 連線,列出 14 個工具,呼叫 search_code_advanced 也回傳了結果。
測試機器遇到的差異
- README: Run build_deep_index, then get_file_summary uses the deep index (the README says indexes are persistently cached).
測試中: 在另一個程序中重新以 stdio 啟動伺服器時,未載入先前建立的深度索引:get_file_summary 回傳 needs_deep_index(指令 7),get_symbol_body 回傳 'deep index not built'(指令 8)。為了對同一個伺服器執行多次呼叫,改以 --tran… - README: Launch with uvx code-index-mcp
測試中: uv tool install code-index-mcp 後啟動 code-index-mcp(加上 --project-path 可省去呼叫 set_project_path),即可在斷網狀態下執行。