Proporciona memoria de proyecto persistente y local-first para agentes de codificación con IA, permitiendo almacenar y recuperar decisiones arquitectónicas, lecciones de depuración y convenciones.
También conocido como vasikmansuri/devmemory, @vasikmansuri/devmemory
- Stars
- 14
- Herramientas
- 9
- Descargas, 30 días
- —
- Última versión
- —
- Último commit
- 2 nov 2026
- Licencia
- MIT
¿Qué es devmemory MCP?
devmemory es un MCP server. Proporciona memoria de proyecto persistente y local-first para agentes de codificación con IA, permitiendo almacenar y recuperar decisiones arquitectónicas, lecciones de depuración y convenciones. Expone 9 herramientas, como memory_save, memory_search, memory_get.
Resumen generado a partir del README del proyecto
Acerca del MCP server de devmemory
DevMemory ofrece una forma local-first para que los agentes de codificación con IA mantengan una memoria a largo plazo de la información específica del proyecto. Permite que herramientas como Claude Code y Cursor almacenen y recuperen decisiones arquitectónicas, lecciones de depuración y convenciones de programación a través de diferentes sesiones. Al utilizar el Model Context Protocol mediante stdio, el servidor garantiza que tu asistente de IA no olvide el contexto crítico cada vez que comienza una nueva conversación.
El sistema funciona completamente en tu máquina utilizando una base de datos SQLite local almacenada en tu directorio de usuario. No requiere una cuenta, conexión a la nube ni telemetría. Para garantizar la seguridad, el servidor redacta información sensible como API keys y contraseñas antes de guardarlas. También trata las memorias recuperadas como datos no confiables para proteger contra prompt injection. Los desarrolladores pueden gestionar esta memoria a través de una CLI dedicada con 15 comandos o mediante 9 herramientas MCP específicas que incluyen memory_save, memory_search y memory_context.
Qué puedes hacer con él
- 1Preservar decisiones arquitectónicasInstruye a un agente de IA para que guarde una elección tecnológica específica para que pueda ser recordada en sesiones futuras.
- 2Evitar repetir pasos de depuraciónAlmacena una lección aprendida de un error difícil para evitar que la IA cometa el mismo error nuevamente.
- 3Aplicar estándares de codificación de equipoProporciona a la IA las convenciones y restricciones específicas del proyecto para asegurar una generación de código consistente.
- 4Automatizar la gestión del conocimientoUtiliza la interfaz de línea de comandos para importar o exportar programáticamente la memoria del proyecto como JSON.
Escrito a partir del README del proyecto. Cada caso de uso se verifica con una cita del mismo.
Cómo instalar devmemory MCP
Formatos verificados el 10 nov 2026Añadir a CursorAñadir a GooseInstalar devmemory MCP en Claude Code
$ claude mcp add devmemory -- npx -y @vasikmansuri/devmemoryInstalar devmemory MCP en Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"devmemory": {
"command": "npx",
"args": [
"-y",
"@vasikmansuri/devmemory"
]
}
}
}Instalar devmemory MCP en VS Code
.vscode/mcp.json
{
"servers": {
"devmemory": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@vasikmansuri/devmemory"
]
}
}
}Instalar devmemory MCP en VS Code CLI
$ code --add-mcp '{"name":"devmemory","type":"stdio","command":"npx","args":["-y","@vasikmansuri/devmemory"]}'Instalar devmemory MCP en Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"devmemory": {
"command": "npx",
"args": [
"-y",
"@vasikmansuri/devmemory"
]
}
}
}Instalar devmemory MCP en Codex
$ codex mcp add devmemory -- npx -y @vasikmansuri/devmemoryInstalar devmemory MCP en Codex config.toml
~/.codex/config.toml
[mcp_servers.devmemory] command = "npx" args = ["-y", "@vasikmansuri/devmemory"]
Instalar devmemory MCP en Gemini CLI
$ gemini mcp add -s user devmemory npx -- -y @vasikmansuri/devmemoryInstalar devmemory MCP en Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"devmemory": {
"command": "npx",
"args": [
"-y",
"@vasikmansuri/devmemory"
]
}
}
}Herramientas de devmemory MCP 9
Detectado desde el READMEmemory_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 | — |
Verificaciones automáticas
Ejecutado 13 nov 2026Informe completo →Pasó nuestras verificaciones automáticas. Esto no es una auditoría de seguridad: lee el código y dale al servidor el acceso más limitado que necesite. Cómo funcionan las verificaciones
- Repositorio de origen vinculado y accesibleAprobado
- Licencia de código abierto (OSI)Aprobado
- Commit o lanzamiento en el último añoAprobado
- El nombre del paquete no es similar a un paquete popularAprobado
- El endpoint remoto usa HTTPSNo verificado
- Las herramientas destructivas están etiquetadasAprobado
- Sin instrucciones ocultas para el modeloAprobado
- No hay avisos críticos en el paquete ni en sus dependenciasNo verificado
README
Ver en GitHub🧠 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:
Preguntas sobre devmemory MCP
¿Cómo agrego devmemory MCP a Claude Code?
Ejecuta claude mcp add devmemory -- npx -y @vasikmansuri/devmemory en tu terminal. Añade --scope user para que esté disponible en todos los proyectos.
¿Cómo agrego devmemory MCP a Cursor?
Abre ~/.cursor/mcp.json y añade el servidor en mcpServers, usando la configuración de Cursor que se muestra en la sección de instalación de arriba.
¿Qué herramientas proporciona devmemory MCP?
Expone 9 herramientas, incluidas memory_save, memory_search, memory_get, memory_update, memory_forget.
¿Cómo maneja la información sensible como las API keys?
El servidor realiza una redacción de secretos, ocultando las claves de AWS, tokens de GitHub y otras credenciales privadas antes de que se almacene cualquier dato.
¿Es compatible con la búsqueda semántica?
Actualmente utiliza la búsqueda de palabras clave de texto completo SQLite FTS5 en lugar de búsqueda semántica, aunque la búsqueda semántica está en la hoja de ruta.
¿Puedo usarlo con Claude Code?
Sí, está verificado de extremo a extremo con Claude Code.