先釐清:這不是 Neo4j 選型
Codebase Memory MCP 的發行版是面向本機使用的程式碼智慧工具。它會把索引與圖譜資料保存在本機,由 MCP 工具提供搜尋、追蹤與查詢;官方安裝流程不要求另外部署 Neo4j。
因此,下表只保留對讀者真正有用的邊界:
| 評估維度 | Codebase Memory 本地圖譜 |
|---|---|
| 部署複雜度 | 以本機單一工具與索引資料為主,不需 Neo4j 服務 |
| 查詢方式 | 透過 MCP 工具與 CLI;依工具提供的 schema 查詢 |
| 適用範圍 | 程式碼結構探索、呼叫鏈、影響分析與本地索引 |
| 資料位置 | 本機;實際路徑與格式以目前發行版設定為準 |
本地索引的實務重點
對於單人開發或一般專案,應把重點放在索引生命週期,而不是自行替換資料庫:
- 先索引再查詢:首次使用先執行
index_repository,確認索引狀態後再使用search_graph、trace_path或query_graph。 - 資料一致性優先:程式碼大幅變更、索引損壞或工具升級後,依官方文件重新建立索引;不要手動改寫內部資料庫。
不要照抄 Neo4j 設定
本章舊版曾把 Codebase Memory 寫成可切換 Neo4j 的系統,這會讓讀者誤以為下列設定可用。那是錯誤示例:
- 不要安裝或啟動 Neo4j 來完成一般 Codebase Memory 安裝。
- 不要假設
--storage neo4j、Bolt URI 或 Neo4j Browser 是本工具的官方設定。
結論與配置選擇
正確做法是沿用官方安裝器與 MCP 設定,並用工具本身提供的索引與查詢介面:
codebase-memory-mcp install
完成 MCP 設定後,透過 index_repository 建立索引,再用 search_graph、trace_path
或 query_graph 查詢。