SQLite、セマンティック検索、および関連エンティティを使用して、セッションをまたいでプロジェクトのコンテキストを維持するための、コーディングエージェント向け共有ローカルメモリを提供します。
別名 sonic182/graphmem, @sonic182/graphmem
- スター
- 9
- ツール
- —
- ダウンロード数(30日間)
- —
- 最新バージョン
- 0.15.2
- 最終コミット
- 2026年11月8日
- ライセンス
- MIT
Graphmem MCPとは
SQLite、セマンティック検索、および関連エンティティを使用して、セッションをまたいでプロジェクトのコンテキストを維持するための、コーディングエージェント向け共有ローカルメモリを提供します。
プロジェクトのREADMEから生成された概要
Graphmem MCP server について
Graphmemは、コーディングエージェントが異なるセッションやツール間でプロジェクトのコンテキストを維持できるように設計された、共有ローカルメモリシステムを提供します。SQLiteストレージとローカルのセマンティック検索を使用して関連エンティティを保存するため、Claude Code、Codex、OpenCode、piなどの複数のMCPクライアントが同じデータストアにアクセスできます。この構成により、コーディングセッション中に行われた決定が永続化され、後でアクセス可能になります。
ユーザーは、npm経由、またはプラットフォーム固有のバイナリをダウンロードすることでサーバーをインストールできます。システムはメモリのスコープとしてデフォルトで現在のGitリポジトリを使用しますが、グローバルスコープもサポートしています。開発者は、コマンドラインインターフェースまたはMCPツールを通じてメモリを管理できます。サーバーは、GRAPHMEM_HOME環境変数が変更されない限り、すべてのデータを ~/.graphmem ディレクトリに保存します。
メモリ管理に加えて、サーバーにはオプションのコードナビゲーションツールが含まれています。これらのツールにより、エージェントはシンボルの定義の検索、ファイルのインポートのリストアップ、コードアウトラインの生成、および異なるGitリビジョン間でのシンボルの比較を行うことができます。これらの特定のコード機能は、埋め込みモデルを必要とせずにGitチェックアウト上で動作します。
できること
- 1プロジェクトの決定を永続化する特定のコーディング規約を保存するようエージェントに指示し、将来のセッションでそれを記憶させます。
- 2過去のコンテキストを検索するローカルメモリに保存された特定の情報や以前の指示をAIに検索させます。
プロジェクトの README から作成されています。すべてのユースケースは、その引用と照らし合わせて確認されています。
Graphmem MCPのインストール方法
フォーマット検証日 2026年11月10日Cursor に追加Gooseに追加Claude CodeにGraphmem MCPをインストール
$ claude mcp add graphmem -- npx -y @sonic182/graphmemCursorにGraphmem MCPをインストール
~/.cursor/mcp.json
{
"mcpServers": {
"graphmem": {
"command": "npx",
"args": [
"-y",
"@sonic182/graphmem"
]
}
}
}VS CodeにGraphmem MCPをインストール
.vscode/mcp.json
{
"servers": {
"graphmem": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@sonic182/graphmem"
]
}
}
}VS Code CLIにGraphmem MCPをインストール
$ code --add-mcp '{"name":"graphmem","type":"stdio","command":"npx","args":["-y","@sonic182/graphmem"]}'Claude DesktopにGraphmem MCPをインストール
claude_desktop_config.json
{
"mcpServers": {
"graphmem": {
"command": "npx",
"args": [
"-y",
"@sonic182/graphmem"
]
}
}
}CodexにGraphmem MCPをインストール
$ codex mcp add graphmem -- npx -y @sonic182/graphmemCodex config.tomlにGraphmem MCPをインストール
~/.codex/config.toml
[mcp_servers.graphmem] command = "npx" args = ["-y", "@sonic182/graphmem"]
Gemini CLIにGraphmem MCPをインストール
$ gemini mcp add -s user graphmem npx -- -y @sonic182/graphmemGemini settings.jsonにGraphmem MCPをインストール
~/.gemini/settings.json
{
"mcpServers": {
"graphmem": {
"command": "npx",
"args": [
"-y",
"@sonic182/graphmem"
]
}
}
}自動チェック
実行日 2026年11月13日完全なレポート →自動チェックに合格しました。これはセキュリティ監査ではありません。コードを読み、サーバーに必要最小限のアクセス権を与えてください。 チェックの仕組み
- ソースリポジトリがリンクされており、アクセス可能sonic182/graphmem is public and reachablegithub.com/sonic182/graphmem ↗合格
- パッケージがこのリポジトリをソースとして指定@sonic182/graphmem names sonic182/graphmem as sourcenpmjs.com/package/@sonic182/graphmem ↗合格
- ビルドの来歴 (Sigstore 証明)No build attestation published for this release未チェック
- オープンソースライセンス (OSI)MITspdx.org/licenses/MIT.html ↗合格
- 過去1年以内にコミットまたはリリースありLast commit or release 2026-11-09github.com/sonic182/graphmem ↗合格
- OpenSSF Scorecard未チェック
- パッケージ名が有名なパッケージに酷似していないNo popular package one edit away from @sonic182/graphmem合格
- パッケージおよびその依存関係に重大な勧告なし1 resolved dependencies checked; no critical advisoryosv.dev ↗合格
- モデルへの隠れた指示がない0 tool descriptions and the README read; no override phrases, credential paths or hidden characters合格
- 破壊的なツールがラベル付けされている未チェック
- リモートエンドポイントが MCP ハンドシェイクに応答未チェック
README
GitHubで見るGraphmem

Shared, local memory for coding agents. Keep project decisions across sessions and tools with SQLite storage, local semantic search, and linked entities. Claude Code, Codex, OpenCode, pi, and other MCP clients can share the same store.
Optional code tools find definitions, outline files, list imports, and compare symbols between Git revisions.
Install
npm install --global @sonic182/graphmem
gmem-install
gmem version
The npm package contains launchers. gmem-install explicitly downloads and
verifies the matching CPU binary, or reuses a working native gmem on your
PATH. Package installation itself downloads no binary. After upgrading the
package, run gmem-install again; separately installed binaries are not replaced.
MCP clients that launch servers with npx can run npx -y @sonic182/graphmem mcp.
The graphmem command downloads and verifies the binary on its first run; gmem
never downloads anything on its own.
Alternatively, download your platform's archive from
GitHub Releases, verify
it against SHA256SUMS, and put the extracted executable on your PATH.
Linux releases require glibc 2.39 and OpenSSL 3. For other systems or CUDA,
build from source.
Use it with your coding agent
Plugins include MCP registration, skills, and guidance to recall context before work and save durable decisions afterward.
| Agent | Install |
|---|---|
| Claude Code | claude plugin marketplace add sonic182/graphmem, then claude plugin install graphmem@graphmem |
| Codex | codex plugin marketplace add sonic182/graphmem, then codex plugin add graphmem@graphmem |
| OpenCode | opencode plugin @sonic182/graphmem --global |
| pi | pi install npm:@sonic182/graphmem |
Claude Code and Codex need gmem and Node.js on PATH. In Codex, trust the
Graphmem hooks in /hooks and start a new thread. Pi offers binary setup on first
startup; OpenCode prints an installer command if needed.
See plugin setup and troubleshooting.
For another MCP client, configure it to launch your installed binary:
{
"mcpServers": {
"graphmem": {
"command": "/absolute/path/to/gmem",
"args": ["mcp"]
}
}
}
CLI
gmem remember "Use nextest for integration tests" \
--type convention --scope repo:/absolute/path/to/project
gmem search "integration tests"
gmem tokens --over-limit # memories the embedding model truncates
gmem tui
gmem mcp
Memories default to the current Git repository; git must be on PATH.
Outside a repository, the default scope is global. Reads always include global
memories; explicitly select other projects with --scope (CLI) or scopes (MCP).
Writes are limited to the current repository and global, including updates and
deletions. The MCP list_scopes tool discovers scopes and their write permissions;
list pages through the memories of a selection.
Data lives in ~/.graphmem; set GRAPHMEM_HOME to use another directory.
CLI reference · MCP tool reference
Code navigation (optional)
Release binaries include these tools; source builds need --features code.
| MCP tool | Purpose |
|---|---|
find_symbol |
Find a definition and its source range |
code_outline |
List a file's definitions and nesting |
code_imports |
List declared imports |
code_diff |
Compare symbols between Git revisions |
gmem code find CodeService
gmem code outline src/application/code.rs
gmem code imports src/application/code.rs
gmem code diff origin/master
These tools work on Git checkouts without an embedding model. They index
definitions, not call sites or references; use ast-grep for those.
Set GRAPHMEM_CODE=off to disable code tools.
Options and supported languages · Benchmark results and limitations
Configuration
No config file is required. To customize embeddings, retrieval, or code indexing,
create ~/.graphmem/config.toml. See the configuration reference.
Build
See source builds and CUDA setup.
Development
just verify
Runs formatting checks, compilation, Clippy, and tests. Design · Schema evolution
To preview the documentation site, run hugo server --source site.
See site setup.
License
MIT.
Graphmem MCPのよくある質問
Graphmem MCPをClaude Codeに追加するには
ターミナルでclaude mcp add graphmem -- npx -y @sonic182/graphmemを実行します。すべてのプロジェクトで利用するには--scope userを追加します。
Graphmem MCPをCursorに追加するには
~/.cursor/mcp.jsonを開き、上記のインストールセクションに示すCursor設定を使ってmcpServersの下にサーバーを追加します。
MCPクライアントで使用するためにGraphmemをインストールするにはどうすればよいですか?
npm install --global @sonic182/graphmem を実行して npm 経由でインストールし、その後 gmem-install を実行するか、npx をサポートしているクライアントの場合は npx -y @sonic182/graphmem mcp を使用してください。
メモリデータはどこに保存されますか?
データは ~/.graphmem ディレクトリにローカルに保存されますが、GRAPHMEM_HOME 環境変数を設定することで変更可能です。
Graphmemを使用してコード内をナビゲートできますか?
はい、オプションのコードツールを使用することで、シンボルの定義の検索、ファイルの概要表示、インポートのリストアップ、Gitリビジョン間でのシンボルの比較が可能です。
Graphmemには設定ファイルが必要ですか?
デフォルトでは設定ファイルは不要ですが、~/.graphmem/config.toml を作成することで、埋め込み、検索、またはコードインデックスをカスタマイズできます。