Yapay zeka kodlama ajanlarının mimari kararları, hata ayıklama derslerini ve standartları saklaması ve geri çağırması için kalıcı, yerel öncelikli proje belleği sağlar.
Ayrıca bilinen adı vasikmansuri/devmemory, @vasikmansuri/devmemory
- Yıldızlar
- 14
- Araçlar
- 9
- İndirmeler, 30 gün
- —
- En son sürüm
- —
- Son commit
- 2 Kas 2026
- Lisans
- MIT
devmemory MCP nedir?
devmemory bir MCP sunucusudur. Yapay zeka kodlama ajanlarının mimari kararları, hata ayıklama derslerini ve standartları saklaması ve geri çağırması için kalıcı, yerel öncelikli proje belleği sağlar. 9 araç sunar; örneğin memory_save, memory_search, memory_get.
Özet, projenin README dosyasından oluşturuldu
devmemory MCP sunucusu hakkında
DevMemory, yapay zeka kodlama ajanlarının projeye özgü bilgileri uzun süreli bellekte tutmaları için yerel öncelikli bir yöntem sunar. Claude Code ve Cursor gibi araçların mimari kararları, hata ayıklama derslerini ve kodlama standartlarını farklı oturumlar arasında saklamasına ve geri çağırmasına olanak tanır. Sunucu, stdio üzerinden Model Context Protocol kullanarak yapay zeka asistanınızın her yeni konuşma başladığında kritik bağlamı unutmamasını sağlar.
Sistem, ana dizininizde saklanan yerel bir SQLite veritabanı kullanarak tamamen kendi makinenizde çalışır. Hesap, bulut bağlantısı veya telemetri gerektirmez. Güvenliği sağlamak için sunucu, API anahtarları ve şifreler gibi hassas bilgileri kaydedilmeden önce maskeler. Ayrıca, prompt injection saldırılarına karşı koruma sağlamak amacıyla geri çağrılan bellekleri güvenilmeyen veri olarak işler. Geliştiriciler bu belleği, 15 komut içeren özel bir CLI üzerinden veya memory_save, memory_search ve memory_context dahil olmak üzere 9 spesifik MCP aracıyla yönetebilir.
Neler yapabilirsiniz
- 1Mimari kararları koruyunBelirli bir teknoloji seçimini gelecekteki oturumlarda hatırlanabilmesi için bir yapay zeka ajanına kaydetmesini söyleyin.
- 2Hata ayıklama adımlarını tekrarlamaktan kaçınınYapay zekanın aynı hatayı tekrar yapmasını önlemek için zorlu bir hatadan çıkarılan dersi saklayın.
- 3Ekip kodlama standartlarını uygulayınTutarlı kod üretimi sağlamak için yapay zekaya projeye özgü kuralları ve kısıtlamaları sunun.
- 4Bilgi yönetimini otomatize edinProje belleğini programatik olarak JSON formatında içe veya dışa aktarmak için komut satırı arayüzünü kullanın.
Projenin README dosyasından alınmıştır. Her kullanım durumu, oradaki bir alıntı ile kontrol edilir.
devmemory MCP nasıl yüklenir
Biçimler 10 Kas 2026 tarihinde doğrulandıCursor'a ekleGoose'a ekledevmemory MCP'yi Claude Code içine yükleyin
$ claude mcp add devmemory -- npx -y @vasikmansuri/devmemorydevmemory MCP'yi Cursor içine yükleyin
~/.cursor/mcp.json
{
"mcpServers": {
"devmemory": {
"command": "npx",
"args": [
"-y",
"@vasikmansuri/devmemory"
]
}
}
}devmemory MCP'yi VS Code içine yükleyin
.vscode/mcp.json
{
"servers": {
"devmemory": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@vasikmansuri/devmemory"
]
}
}
}devmemory MCP'yi VS Code CLI içine yükleyin
$ code --add-mcp '{"name":"devmemory","type":"stdio","command":"npx","args":["-y","@vasikmansuri/devmemory"]}'devmemory MCP'yi Claude Desktop içine yükleyin
claude_desktop_config.json
{
"mcpServers": {
"devmemory": {
"command": "npx",
"args": [
"-y",
"@vasikmansuri/devmemory"
]
}
}
}devmemory MCP'yi Codex içine yükleyin
$ codex mcp add devmemory -- npx -y @vasikmansuri/devmemorydevmemory MCP'yi Codex config.toml içine yükleyin
~/.codex/config.toml
[mcp_servers.devmemory] command = "npx" args = ["-y", "@vasikmansuri/devmemory"]
devmemory MCP'yi Gemini CLI içine yükleyin
$ gemini mcp add -s user devmemory npx -- -y @vasikmansuri/devmemorydevmemory MCP'yi Gemini settings.json içine yükleyin
~/.gemini/settings.json
{
"mcpServers": {
"devmemory": {
"command": "npx",
"args": [
"-y",
"@vasikmansuri/devmemory"
]
}
}
}devmemory MCP araçları 9
README dosyasından algılandımemory_savememory_searchmemory_getmemory_updatememory_forgetmemory_listmemory_contextmemory_linkmemory_stats
| memory_save | — | |
| memory_search | — | |
| memory_get | — | |
| memory_update | — | |
| memory_forget | — | |
| memory_list | — | |
| memory_context | — | |
| memory_link | — | |
| memory_stats | — |
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şilebilirGeçti
- Açık kaynak lisansı (OSI)Geçti
- Son bir yıl içinde commit veya sürüm mevcutGeçti
- Paket adı popüler bir pakete yakın değilGeçti
- Uzak uç nokta HTTPS kullanıyorKontrol edilmedi
- Yıkıcı araçlar etiketlenmişGeçti
- Modele yönelik gizli talimat yokGeçti
- Pakette veya bağımlılıklarında kritik uyarı yokKontrol edilmedi
🧠 DevMemory
Persistent, local-first memory for AI coding agents. An MCP server and CLI for Claude Code, Cursor and other MCP clients.
Stop re-explaining your codebase. DevMemory remembers your project's decisions, architecture, debugging lessons and conventions across AI sessions. It runs 100% on your machine.
Quick start · Claude Code · Cursor · MCP tools · CLI · Security · Docs
✨ Why DevMemory?
AI coding assistants like Claude Code and Cursor forget everything when a session ends. Every new conversation, you explain the same architecture, the same "we tried X and it broke", the same team conventions.
DevMemory gives your AI agent long-term project memory through the Model Context Protocol (MCP):
| Without DevMemory | With DevMemory | |
|---|---|---|
| 🗂️ Project decisions | Re-explained every session | Saved once, retrieved automatically |
| 🐛 Debugging lessons | Rediscovered the hard way | Recalled when the same symptom appears |
| 📏 Conventions & constraints | Forgotten mid-task | Included in every relevant context bundle |
| 🔒 Privacy | Context pasted into chats | Stored locally in SQLite, never uploaded |
🚀 Features
- 🏠 Local-first and private. A single SQLite file at
~/.devmemory/. No cloud, no account, no telemetry, no network port. - 🔌 MCP server. 9 tools over stdio, verified with Claude Code. Works with any MCP client.
- 🗃️ Project-scoped memory. Each repository's knowledge is isolated, and no project can read another's.
- 🏷️ Structured memory types: decisions, architecture, debugging lessons, conventions, constraints, task context and facts. Each memory has tags, importance, confidence and an optional expiry.
- 🔎 Fast, explainable search. SQLite FTS5 full-text search with BM25 ranking, weighted by importance, confidence and recency. Every result explains its score.
- 🧾 Provenance. Every memory records where it came from: source, client, file, PR or commit reference, and timestamps.
- 🔐 Secret redaction. API keys, tokens, passwords and private keys are redacted before anything is stored.
- 🛡️ Prompt-injection aware. Retrieved memories are wrapped as untrusted data, and instruction-like content is flagged.
- ♻️ Safe lifecycle. Duplicate detection, conflict surfacing, supersede chains, reversible archiving, and hard deletes that also purge the search index.
- 📦 Import and export. Portable JSON with validation, size limits and protection against path traversal and symlinks.
- 🧰 Developer CLI. 15 commands, JSON output and meaningful exit codes for automation.
🏗️ How it works
flowchart LR
subgraph Clients
CC[🤖 Claude Code]
CU[🖱️ Cursor]
CLI[⌨️ devmemory CLI]
end
subgraph DevMemory["DevMemory (local process)"]
MCP[MCP server<br/>9 tools · stdio]
ENG[Memory engine]
SEC[🔐 Secret redaction<br/>+ validation]
RET[🔎 FTS5 / BM25<br/>ranking]
end
DB[(SQLite<br/>~/.devmemory/devmemory.db)]
CC -- JSON-RPC over stdio --> MCP
CU -- JSON-RPC over stdio --> MCP
CLI --> ENG
MCP --> ENG
ENG --> SEC --> DB
ENG --> RET --> DB
Memory across sessions
sequenceDiagram
actor Dev as Developer
participant S1 as Session 1 (Claude Code)
participant DM as DevMemory
participant S2 as Session 2 (new day)
Dev->>S1: "We chose Drizzle over Prisma because of edge runtimes"
S1->>DM: memory_save(type: decision, ...)
DM-->>S1: ✅ saved (secrets redacted, provenance recorded)
Note over S1: Session ends, the agent forgets everything
Dev->>S2: "Add a new database table"
S2->>DM: memory_context("database table")
DM-->>S2: 📋 Drizzle decision + conventions (with provenance)
S2-->>Dev: Uses Drizzle correctly, without being re-told
⚡ Quick start
Requires Node.js ≥ 22.12.
# 1. Install
npm install -g @vasikmansuri/devmemory
# 2. Verify the CLI is available
devmemory --version
# 3. Register your project
cd ~/code/my-app
devmemory init
# 4. Save knowledge
devmemory remember -t decision --title "Use Drizzle ORM" \
-c "Drizzle over Prisma: Prisma's engine binary breaks on edge runtimes." \
--tags db,orm -i 4 --source-ref docs/adr/0003.md
# 5. Find it again
devmemory search "which orm"
devmemory context "touching the data layer"
git clone https://github.com/vasikmansuri/devmemory.git
cd devmemory
npm ci && npm run build && npm link
devmemory --version
🤖 Connect Claude Code
✅ Verified end to end with Claude Code 2.1.294.
claude mcp add --transport stdio devmemory -- devmemory mcp
Share it with your team via .mcp.json:
claude mcp add --scope project --transport stdio devmemory -- devmemory mcp
Check the connection with claude mcp list or /mcp. Then try "Save to DevMemory: we deploy with Argo CD", start a new session, and ask "how do we deploy?"
💡 Claude Code starts the server in your working directory, and DevMemory finds the nearest registered project automatically, even from subfolders.
🖱️ Connect Cursor
⚠️ Configuration follows Cursor's documented format, but has not been tested end to end yet. Add this to .cursor/mcp.json:
{
"mcpServers": {
"devmemory": {
"type": "stdio",
"command": "devmemory",
"args": ["mcp", "--project", "${workspaceFolder}"]
}
}
}
🧩 MCP tools
| Tool | Description |
|---|---|
memory_save |
Save a memory. Reports duplicates and possible conflicts; can supersede older memories. |
memory_search |
Ranked keyword search with type, tag and status filters. |
memory_get |
Fetch one memory with links and lifecycle history. |
memory_update |
Edit in place; previous values are kept in history. |
memory_forget |
Archive (reversible) or permanently delete (confirm: true). |
memory_list |
Paginated, filtered listing. |
memory_context |
A token-budgeted context bundle for the current task. |
memory_link |
Relate memories: depends_on, conflicts_with, … |
memory_stats |
Project statistics. |
⌨️ CLI reference
| Command | Purpose |
|---|---|
devmemory init |
Register the current directory as a project |
devmemory remember |
Save a memory (-c - reads stdin) |
devmemory search <query> |
Ranked keyword search |
devmemory get <id> |
Full memory with provenance and history |
devmemory list |
Browse with filters and pagination |
devmemory context [query] |
The context bundle an agent receives |
devmemory update <id> |
Edit a memory |
devmemory forget <id> |
Archive, or --hard --yes to delete |
devmemory link <a> <b> |
Link two memories |
devmemory stats · projects · doctor |
Statistics, project list, health checks |
devmemory export · import |
Portable JSON backup and restore |
devmemory mcp |
Run the MCP server (stdio) |
Add --json to any command for machine-readable output.
Exit codes: 0 ok · 1 internal error · 2 validation · 3 not found · 4 project not initialized · 5 conflict · 6 database error · 7 I/O or unsafe path.
📊 Search quality (measured, not claimed)
These numbers come from 36 labelled queries over a 46-memory test project (npm run eval):
| Metric | All queries | Direct wording | Paraphrased |
|---|---|---|---|
| Recall@5 | 0.944 | 1.000 | 0.750 |
| MRR | 0.922 | 1.000 | 0.650 |
| Precision@5 (max achievable 0.228) | 0.217 | 0.229 | 0.175 |
DevMemory uses keyword search, not semantic search, so paraphrased questions with no shared words can miss. Semantic search is on the roadmap.
🔐 Security & privacy
- ✅ Runs locally: no telemetry, no network listener, no external API calls.
- ✅ Secrets are redacted before storage, covering AWS keys, GitHub tokens, OpenAI and Anthropic keys, JWTs, private keys and passwords.
- ✅ The database file is readable only by your user (mode
0600). - ✅ Projects are isolated, and all SQL is parameterized.
- ✅ Retrieved memories are treated as untrusted data, never as instructions.
- ⚠️ The database is not encrypted at rest. Use full-disk encryption for extra protection.
Read more in the security model and SECURITY.md.
⚙️ Configuration
| Variable | Default | Purpose |
|---|---|---|
DEVMEMORY_HOME |
~/.devmemory |
Data directory |
DEVMEMORY_PROJECT |
current dir | Project to use |
DEVMEMORY_SECRET_POLICY |
redact |
redact or reject writes containing secrets |
DEVMEMORY_EXTRA_TYPES |
— | Extra memory types, comma-separated |
DEVMEMORY_LOG_LEVEL |
warn |
Log level (stderr only) |
📚 Documentation
Architecture · Memory model · Security model · MCP integration · Troubleshooting · Retrieval evaluation · Roadmap · Contributing · Changelog
🛣️ Roadmap
- Local MCP server, CLI, FTS5 search, secret redaction, project isolation
- Verified Claude Code integration
- Optional local embeddings for semantic search
- End-to-end verified Cursor integration
- Better tokenization for Chinese and Japanese text
- Opt-in encryption at rest
🤝 Contributing
Contributions are welcome! Run npm run check (typecheck, lint, 129 tests, build) and see CONTRIBUTING.md.
⚠️ Known limitations
- Keyword search only (no semantic search yet).
- Chinese and Japanese text is tokenized coarsely.
- Moving a project folder requires running
devmemory initagain. - The Cursor integration is unverified.
📄 License
MIT © Vasik Mansuri
If DevMemory saves you from re-explaining your codebase, please ⭐ star the repo!
Keywords: AI memory · MCP server · Model Context Protocol · Claude Code memory · Cursor MCP · AI coding assistant · persistent context · long-term memory for LLM agents · local-first · SQLite FTS5 · developer tools
Support
If this project is useful to you, you can support my open-source work:
devmemory MCP soruları
devmemory MCP'yi Claude Code'a nasıl eklerim?
Terminalinizde claude mcp add devmemory -- npx -y @vasikmansuri/devmemory komutunu çalıştırın. Her projede kullanılabilir olması için --scope user ekleyin.
devmemory 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.
devmemory MCP hangi araçları sunar?
9 araç sunar; bunlar arasında memory_save, memory_search, memory_get, memory_update, memory_forget yer alır.
API anahtarları gibi hassas bilgileri nasıl işliyor?
Sunucu, herhangi bir veri saklanmadan önce AWS anahtarları, GitHub tokenları ve diğer özel kimlik bilgilerini gizleyerek hassas veri maskeleme işlemi gerçekleştirir.
Semantik arama desteği var mı?
Şu anda semantik arama yerine SQLite FTS5 tam metin anahtar kelime aramasını kullanıyor, ancak semantik arama yol haritasında yer alıyor.
Claude Code ile kullanabilir miyim?
Evet, Claude Code ile uçtan uca doğrulanmıştır.