AI 코딩 에이전트가 아키텍처 결정 사항, 디버깅 교훈, 컨벤션을 저장하고 검색할 수 있도록 지속 가능한 로컬 우선 프로젝트 메모리를 제공합니다.
다른 이름 vasikmansuri/devmemory, @vasikmansuri/devmemory
- 스타
- 14
- Tools
- 9
- 다운로드, 30일
- —
- 최신 버전
- —
- 마지막 커밋
- 2026년 11월 2일
- 라이선스
- MIT
devmemory MCP란?
devmemory은(는) MCP server입니다. AI 코딩 에이전트가 아키텍처 결정 사항, 디버깅 교훈, 컨벤션을 저장하고 검색할 수 있도록 지속 가능한 로컬 우선 프로젝트 메모리를 제공합니다. 9개 도구를 제공합니다. 예: memory_save, memory_search, memory_get.
프로젝트 README에서 생성된 요약
devmemory MCP server 정보
DevMemory는 AI 코딩 에이전트가 프로젝트별 정보를 장기적으로 기억할 수 있도록 로컬 우선 방식을 제공합니다. Claude Code 및 Cursor와 같은 도구가 서로 다른 세션 전반에 걸쳐 아키텍처 결정 사항, 디버깅 교훈, 코딩 컨벤션을 저장하고 검색할 수 있도록 지원합니다. stdio를 통해 Model Context Protocol을 사용함으로써, 새로운 대화가 시작될 때마다 AI 어시스턴트가 중요한 컨텍스트를 잊어버리지 않도록 보장합니다.
이 시스템은 홈 디렉토리에 저장된 로컬 SQLite 데이터베이스를 사용하여 사용자의 기기에서 완전히 작동합니다. 계정, 클라우드 연결 또는 텔레메트리가 필요하지 않습니다. 보안을 위해 서버는 API 키 및 비밀번호와 같은 민감한 정보를 저장하기 전에 삭제합니다. 또한 프롬프트 인젝션을 방지하기 위해 검색된 메모리를 신뢰할 수 없는 데이터로 취급합니다. 개발자는 15개의 명령어를 제공하는 전용 CLI 또는 memory_save, memory_search, memory_context를 포함한 9개의 특정 MCP 도구를 통해 이 메모리를 관리할 수 있습니다.
활용 사례
- 1아키텍처 결정 사항 보존AI 에이전트에게 특정 기술 선택 사항을 저장하도록 지시하여 향후 세션에서 다시 불러올 수 있습니다.
- 2디버깅 단계 반복 방지어려운 버그에서 얻은 교훈을 저장하여 AI가 동일한 실수를 반복하지 않도록 합니다.
- 3팀 코딩 표준 강제AI에게 프로젝트별 컨벤션과 제약 사항을 제공하여 일관된 코드 생성을 보장합니다.
- 4지식 관리 자동화명령줄 인터페이스를 사용하여 프로젝트 메모리를 JSON 형식으로 프로그래밍 방식으로 가져오거나 내보냅니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
devmemory MCP 설치 방법
형식 확인: 2026년 11월 10일Cursor에 추가Goose에 추가Claude Code에 devmemory MCP 설치
$ claude mcp add devmemory -- npx -y @vasikmansuri/devmemoryCursor에 devmemory MCP 설치
~/.cursor/mcp.json
{
"mcpServers": {
"devmemory": {
"command": "npx",
"args": [
"-y",
"@vasikmansuri/devmemory"
]
}
}
}VS Code에 devmemory MCP 설치
.vscode/mcp.json
{
"servers": {
"devmemory": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@vasikmansuri/devmemory"
]
}
}
}VS Code CLI에 devmemory MCP 설치
$ code --add-mcp '{"name":"devmemory","type":"stdio","command":"npx","args":["-y","@vasikmansuri/devmemory"]}'Claude Desktop에 devmemory MCP 설치
claude_desktop_config.json
{
"mcpServers": {
"devmemory": {
"command": "npx",
"args": [
"-y",
"@vasikmansuri/devmemory"
]
}
}
}Codex에 devmemory MCP 설치
$ codex mcp add devmemory -- npx -y @vasikmansuri/devmemoryCodex config.toml에 devmemory MCP 설치
~/.codex/config.toml
[mcp_servers.devmemory] command = "npx" args = ["-y", "@vasikmansuri/devmemory"]
Gemini CLI에 devmemory MCP 설치
$ gemini mcp add -s user devmemory npx -- -y @vasikmansuri/devmemoryGemini settings.json에 devmemory MCP 설치
~/.gemini/settings.json
{
"mcpServers": {
"devmemory": {
"command": "npx",
"args": [
"-y",
"@vasikmansuri/devmemory"
]
}
}
}devmemory MCP 도구 9
README에서 감지됨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 | — |
자동 검사
2026년 11월 13일에 실행됨전체 보고서 →자동 검사를 통과했습니다. 이는 보안 감사가 아닙니다. 코드를 직접 읽고 서버에 필요한 최소한의 권한만 부여하십시오. 검사 방식
- 소스 저장소 연결 및 접근 가능통과
- 오픈 소스 라이선스 (OSI)통과
- 최근 1년 내 커밋 또는 릴리스통과
- 패키지 이름이 인기 패키지와 유사하지 않음통과
- 원격 엔드포인트가 HTTPS 사용검사되지 않음
- 파괴적인 도구에 라벨 표시됨통과
- 모델에 대한 숨겨진 지침 없음통과
- 패키지 및 해당 종속성에 중요한 보안 권고 없음검사되지 않음
README
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:
devmemory MCP 질문
devmemory MCP를 Claude Code에 추가하려면 어떻게 하나요?
터미널에서 claude mcp add devmemory -- npx -y @vasikmansuri/devmemory를 실행합니다. 모든 프로젝트에서 사용할 수 있게 하려면 --scope user를 추가합니다.
devmemory MCP를 Cursor에 추가하려면 어떻게 하나요?
~/.cursor/mcp.json를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
devmemory MCP는 어떤 도구를 제공하나요?
9개 도구를 제공합니다. 예: memory_save, memory_search, memory_get, memory_update, memory_forget.
API 키와 같은 민감한 정보는 어떻게 처리하나요?
서버에서 비밀 정보 삭제(redaction)를 수행하여 AWS 키, GitHub 토큰 및 기타 개인 자격 증명을 저장하기 전에 가립니다.
시맨틱 검색을 지원하나요?
현재는 시맨틱 검색 대신 SQLite FTS5 전체 텍스트 키워드 검색을 사용하며, 시맨틱 검색은 향후 로드맵에 포함되어 있습니다.
Claude Code와 함께 사용할 수 있나요?
네, Claude Code와 엔드 투 엔드 검증을 완료했습니다.