Theme / v0.10.8

Codebase Memory

程式碼記憶與知識圖譜 MCP

基礎觀念

Codebase Memory 的本地圖譜儲存邊界

說明 Codebase Memory 的本地儲存方式、查詢邊界,以及為什麼不應把它當成 Neo4j 部署指南

先釐清:這不是 Neo4j 選型

Codebase Memory MCP 的發行版是面向本機使用的程式碼智慧工具。它會把索引與圖譜資料保存在本機,由 MCP 工具提供搜尋、追蹤與查詢;官方安裝流程不要求另外部署 Neo4j。

因此,下表只保留對讀者真正有用的邊界:

評估維度 Codebase Memory 本地圖譜
部署複雜度 以本機單一工具與索引資料為主,不需 Neo4j 服務
查詢方式 透過 MCP 工具與 CLI;依工具提供的 schema 查詢
適用範圍 程式碼結構探索、呼叫鏈、影響分析與本地索引
資料位置 本機;實際路徑與格式以目前發行版設定為準

本地索引的實務重點

對於單人開發或一般專案,應把重點放在索引生命週期,而不是自行替換資料庫:

  • 先索引再查詢:首次使用先執行 index_repository,確認索引狀態後再使用 search_graphtrace_pathquery_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 查詢。