SQLite, semantik arama ve bağlantılı varlıklar kullanarak kodlama ajanlarının oturumlar arası proje bağlamını koruması için paylaşımlı yerel bellek sağlar.
Ayrıca bilinen adı sonic182/graphmem, @sonic182/graphmem
- Yıldızlar
- 9
- Araçlar
- —
- İndirmeler, 30 gün
- —
- En son sürüm
- 0.15.2
- Son commit
- 8 Kas 2026
- Lisans
- MIT
Graphmem MCP nedir?
SQLite, semantik arama ve bağlantılı varlıklar kullanarak kodlama ajanlarının oturumlar arası proje bağlamını koruması için paylaşımlı yerel bellek sağlar.
Özet, projenin README dosyasından oluşturuldu
Graphmem MCP sunucusu hakkında
Graphmem, kodlama ajanlarının farklı oturumlar ve araçlar arasında proje bağlamını koruması için tasarlanmış paylaşımlı bir yerel bellek sistemi sunar. Bağlantılı varlıkları saklamak için SQLite depolama ve yerel semantik arama kullanır; bu sayede Claude Code, Codex, OpenCode ve pi gibi birden fazla MCP istemcisinin aynı veri deposuna erişmesine olanak tanır. Bu kurulum, bir kodlama oturumu sırasında alınan kararların kalıcı olmasını ve daha sonra erişilebilir kalmasını sağlar.
Kullanıcılar sunucuyu npm üzerinden veya platforma özel ikili dosyaları (binaries) indirerek kurabilirler. Sistem, bellek kapsamı (scoping) için varsayılan olarak mevcut Git deposunu kullanır, ancak global kapsamı da destekler. Geliştiriciler bellekleri bir komut satırı arayüzü veya MCP araçları aracılığıyla yönetebilirler. GRAPHMEM_HOME ortam değişkeni değiştirilmediği sürece sunucu tüm verileri ~/.graphmem dizininde saklar.
Bellek yönetiminin ötesinde, sunucu isteğe bağlı kod navigasyon araçlarını da içerir. Bu araçlar, ajanların sembol tanımlarını bulmasına, dosya içe aktarmalarını listelemesine, kod taslakları oluşturmasına ve farklı Git revizyonları arasındaki sembolleri karşılaştırmasına olanak tanır. Bu özel kod özellikleri, bir embedding modeline ihtiyaç duymadan Git checkout'ları üzerinde çalışır.
Neler yapabilirsiniz
- 1Proje kararlarını kalıcı hale getirinGelecekteki oturumlarda hatırlanması için bir ajana belirli bir kodlama kuralını kaydetmesini söyleyin.
- 2Geçmiş bağlam içinde arama yapınYapay zekadan yerel bellekte saklanan belirli bilgileri veya önceki talimatları bulmasını isteyin.
Projenin README dosyasından alınmıştır. Her kullanım durumu, oradaki bir alıntı ile kontrol edilir.
Graphmem MCP nasıl yüklenir
Biçimler 10 Kas 2026 tarihinde doğrulandıCursor'a ekleGoose'a ekleGraphmem MCP'yi Claude Code içine yükleyin
$ claude mcp add graphmem -- npx -y @sonic182/graphmemGraphmem MCP'yi Cursor içine yükleyin
~/.cursor/mcp.json
{
"mcpServers": {
"graphmem": {
"command": "npx",
"args": [
"-y",
"@sonic182/graphmem"
]
}
}
}Graphmem MCP'yi VS Code içine yükleyin
.vscode/mcp.json
{
"servers": {
"graphmem": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@sonic182/graphmem"
]
}
}
}Graphmem MCP'yi VS Code CLI içine yükleyin
$ code --add-mcp '{"name":"graphmem","type":"stdio","command":"npx","args":["-y","@sonic182/graphmem"]}'Graphmem MCP'yi Claude Desktop içine yükleyin
claude_desktop_config.json
{
"mcpServers": {
"graphmem": {
"command": "npx",
"args": [
"-y",
"@sonic182/graphmem"
]
}
}
}Graphmem MCP'yi Codex içine yükleyin
$ codex mcp add graphmem -- npx -y @sonic182/graphmemGraphmem MCP'yi Codex config.toml içine yükleyin
~/.codex/config.toml
[mcp_servers.graphmem] command = "npx" args = ["-y", "@sonic182/graphmem"]
Graphmem MCP'yi Gemini CLI içine yükleyin
$ gemini mcp add -s user graphmem npx -- -y @sonic182/graphmemGraphmem MCP'yi Gemini settings.json içine yükleyin
~/.gemini/settings.json
{
"mcpServers": {
"graphmem": {
"command": "npx",
"args": [
"-y",
"@sonic182/graphmem"
]
}
}
}Otomatik kontroller
Çalıştırıldı 13 Kas 2026Tam rapor →Otomatik kontrollerimizden geçti. Bu bir güvenlik denetimi değildir: kodu okuyun ve sunucuya ihtiyaç duyduğu en dar erişimi verin. Kontroller nasıl çalışır
- Kaynak deposu bağlantılı ve erişilebilirsonic182/graphmem is public and reachablegithub.com/sonic182/graphmem ↗Geçti
- Paket, bu depoyu kaynağı olarak gösteriyor@sonic182/graphmem names sonic182/graphmem as sourcenpmjs.com/package/@sonic182/graphmem ↗Geçti
- Derleme kökeni (Sigstore onayı)No build attestation published for this releaseKontrol edilmedi
- Açık kaynak lisansı (OSI)MITspdx.org/licenses/MIT.html ↗Geçti
- Son bir yıl içinde commit veya sürüm mevcutLast commit or release 2026-11-09github.com/sonic182/graphmem ↗Geçti
- OpenSSF ScorecardKontrol edilmedi
- Paket adı popüler bir pakete yakın değilNo popular package one edit away from @sonic182/graphmemGeçti
- Pakette veya bağımlılıklarında kritik uyarı yok1 resolved dependencies checked; no critical advisoryosv.dev ↗Geçti
- Modele yönelik gizli talimat yok0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersGeçti
- Yıkıcı araçlar etiketlenmişKontrol edilmedi
- Uzak uç nokta MCP el sıkışmasına yanıt veriyorKontrol edilmedi
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 soruları
Graphmem MCP'yi Claude Code'a nasıl eklerim?
Terminalinizde claude mcp add graphmem -- npx -y @sonic182/graphmem komutunu çalıştırın. Her projede kullanılabilir olması için --scope user ekleyin.
Graphmem MCP'yi Cursor'a nasıl eklerim?
~/.cursor/mcp.json dosyasını açın ve yukarıdaki yükleme bölümünde gösterilen Cursor yapılandırmasını kullanarak sunucuyu mcpServers altına ekleyin.
Bir MCP istemcisi ile kullanmak için Graphmem'i nasıl kurabilirim?
npm üzerinden npm install --global @sonic182/graphmem komutunu çalıştırıp ardından gmem-install komutunu kullanarak veya npx destekleyen istemciler için npx -y @sonic182/graphmem mcp komutuyla kurabilirsiniz.
Bellek verileri nerede saklanır?
Veriler yerel olarak ~/.graphmem dizininde saklanır; ancak GRAPHMEM_HOME ortam değişkenini ayarlayarak bu konumu değiştirebilirsiniz.
Kodlarım arasında gezinmek için Graphmem'i kullanabilir miyim?
Evet, isteğe bağlı kod araçları sayesinde sembol tanımlarını bulabilir, dosya taslaklarını çıkarabilir, içe aktarmaları listeleyebilir ve Git revizyonları arasında sembolleri karşılaştırabilirsiniz.
Graphmem bir yapılandırma dosyasına ihtiyaç duyar mı?
Varsayılan olarak bir yapılandırma dosyası gerekmez, ancak gömme (embeddings), veri getirme veya kod indeksleme işlemlerini özelleştirmek için ~/.graphmem/config.toml dosyasını oluşturabilirsiniz.