codebase-memory-mcp 使用教學:給 Claude Code、Codex 加程式碼庫記憶

整理 DeusData/codebase-memory-mcp 的一鍵安裝、Windows 安裝、UI、自動索引、更新卸載,以及適合 AI 程式 Agent 的程式碼庫記憶場景。

DeusData/codebase-memory-mcp 是一個程式碼智慧 MCP server。它會把程式碼庫索引成持久知識圖譜,讓 Claude Code、Codex、Gemini CLI、Aider、OpenCode 等 Agent 更快查詢專案結構。

專案地址:

https://github.com/DeusData/codebase-memory-mcp

文件站:

https://deusdata.github.io/codebase-memory-mcp/

一鍵安裝

macOS / Linux:

1
curl -fsSL https://raw.githubusercontent.com/DeusData/codebase-memory-mcp/main/install.sh | bash

如果想同時安裝圖形介面:

1
curl -fsSL https://raw.githubusercontent.com/DeusData/codebase-memory-mcp/main/install.sh | bash -s -- --ui

Windows:

1
2
3
4
5
6
7
8
# 1. Download the installer
Invoke-WebRequest -Uri https://raw.githubusercontent.com/DeusData/codebase-memory-mcp/main/install.ps1 -OutFile install.ps1

# 2. (Optional but recommended) Inspect the script
notepad install.ps1

# 3. Run it
.\install.ps1

手動安裝

macOS / Linux 解壓後安裝:

1
2
tar xzf codebase-memory-mcp-*.tar.gz
./install.sh

Windows:

1
2
Expand-Archive codebase-memory-mcp-windows-amd64.zip -DestinationPath .
.\install.ps1

打開 UI

1
codebase-memory-mcp --ui=true --port=9749

自動索引和更新

開啟自動索引:

1
codebase-memory-mcp config set auto_index true

更新:

1
codebase-memory-mcp update

卸載:

1
codebase-memory-mcp uninstall

適合怎麼用

它適合程式碼庫比較大、Agent 經常反覆讀檔案的場景。例如:

  1. 老專案結構複雜,AI 總是找錯入口。
  2. 多語言倉庫裡需要快速查依賴關係。
  3. 想減少 Agent 把大量檔案塞進上下文。
  4. 希望用 MCP 給多個編碼工具共享同一份程式碼記憶。

安裝後建議先讓 Agent 做一個小任務:解釋專案結構、找到某個 API 的呼叫鏈、定位某個設定入口。確認它能正確查詢後,再用於真實改程式碼任務。

记录并分享
使用 Hugo 建立
主題 StackJimmy 設計