codebase-memory-mcp 入門：Claude Code と Codex にコードベース記憶を追加する

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 が同じファイルを何度も読む場面に向いています。たとえば次のような場合です。

古いプロジェクトの構造が複雑で、AI が入口をよく間違える。
多言語リポジトリで依存関係をすばやく調べたい。
Agent が大量のファイルをコンテキストに入れる量を減らしたい。
MCP を使って、複数のコーディングツールで同じコード記憶を共有したい。

インストール後は、まず小さなタスクを Agent に依頼するのがおすすめです。プロジェクト構造の説明、ある API の呼び出しチェーンの発見、設定入口の特定などです。正しく検索できることを確認してから、実際のコード変更タスクに使うとよいです。