agentMemory MCP server
2026년 10월 21일 커밋AI 코딩 에이전트에게 KiloCode, Cline, RooCode의 memory bank markdown 파일과 동기화되는 검색 가능한 로컬 메모리 저장소를 제공합니다.
다른 이름 webzler/agentMemory
- 스타
- 33
- Tools
- 6
- 다운로드, 30일
- —
- 최신 버전
- —
- 마지막 커밋
- 2026년 10월 21일
- 라이선스
- MIT
agentMemory MCP란?
agentMemory은(는) MCP server입니다. AI 코딩 에이전트에게 KiloCode, Cline, RooCode의 memory bank markdown 파일과 동기화되는 검색 가능한 로컬 메모리 저장소를 제공합니다. 6개 도구를 제공합니다. 예: memory_write, memory_read, memory_search.
프로젝트 README에서 생성된 요약
agentMemory MCP server 정보
agentMemory의 주요 기능은 AI 코딩 에이전트에게 검색 가능하고 지속적인 메모리 저장소를 제공하는 것입니다. 이 시스템은 수동 markdown 문서와 구조화된 데이터 사이의 간극을 메워 KiloCode, Cline, RooCode를 사용하는 개발자들을 지원합니다. 로컬 JSON 데이터베이스와 해당 코딩 도구들이 사용하는 기존 markdown memory bank 간의 양방향 동기화를 유지하는 하이브리드 아키텍처를 사용합니다.
사용자는 VS Code Marketplace를 통해 서버를 설치하며, 설치 시 MCP server 설정이 자동으로 구성되고 프로젝트 파일에 필요한 지침이 주입됩니다. 서버가 활성화되면 memory_search, memory_write, memory_read와 같은 도구를 통해 프로그래밍 방식으로 데이터에 접근할 수 있습니다. 이 설정을 통해 에이전트는 전체 파일을 읽지 않고도 유형이나 태그별로 정보를 쿼리할 수 있으며, 시각적 대시보드를 통해 메모리 증가량과 에이전트 활동에 대한 분석 데이터를 확인할 수 있습니다. 시스템이 완전히 로컬 기반의 오프라인 우선 방식으로 설계되었기 때문에 모든 데이터는 사용자의 프로젝트 디렉토리에 유지되며 버전 관리 시스템에 커밋할 수 있습니다.
활용 사례
- 1효율적인 지식 검색개발자는 저장소의 모든 파일을 스캔하는 대신 인덱싱된 검색을 사용하여 에이전트가 특정 코딩 패턴을 찾도록 지시할 수 있습니다.
- 2프로젝트 간 컨텍스트 공유사용자는 여러 프로젝트에 걸쳐 메모리를 쿼리하여 개발 패턴의 일관성을 유지할 수 있습니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
agentMemory MCP 도구 6
README에서 감지됨memory_writememory_readmemory_searchmemory_listmemory_updatememory_stats
| memory_write | — | |
| memory_read | — | |
| memory_search | — | |
| memory_list | — | |
| memory_update | — | |
| memory_stats | — |
자동 검사
2026년 11월 13일에 실행됨전체 보고서 →아직 인증되지 않았습니다. 서버는 80점 이상의 점수, 심각한 결함 없음, 그리고 검사에 충분한 데이터를 갖추어야 합니다. 검사 방식 · 점수를 높이기 위해 수정할 항목
- 소스 저장소 연결 및 접근 가능webzler/agentmemory is public and reachablegithub.com/webzler/agentmemory ↗통과
- 패키지가 이 저장소를 소스로 명시검사되지 않음
- 빌드 출처(Sigstore 증명)검사되지 않음
- 오픈 소스 라이선스 (OSI)MITspdx.org/licenses/MIT.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit or release 2026-10-21github.com/webzler/agentmemory ↗통과
- OpenSSF Scorecard검사되지 않음
- 패키지 이름이 인기 패키지와 유사하지 않음검사되지 않음
- 패키지 및 해당 종속성에 중요한 보안 권고 없음검사되지 않음
- 모델에 대한 숨겨진 지침 없음6 tool descriptions and the README read; no override phrases, credential paths or hidden characters통과
- 파괴적인 도구에 라벨 표시됨No tool named like delete, drop or exec통과
- 원격 엔드포인트가 MCP 핸드셰이크에 응답검사되지 않음
README
GitHub에서 보기🚀 agentMemory
Hybrid Memory System for AI Coding Agents
Seamlessly integrate with KiloCode, Cline, and RooCode's built-in memory banks while providing powerful search, analytics, and automation.
🚀 Now Available as an Antigravity Skill!
agentMemory is now fully compatible with Antigravity. Use it as a skill to give your agents persistent, searchable memory that syncs with your project documentation.
See SKILL.md for usage instructions.
🎯 What Makes agentMemory Different?
KiloCode, Cline, and RooCode already have memory banks - but they're manual and limited.
Their Built-In Memory Banks
.kilocode/rules/memory-bank/ ← Markdown files
.clinerules/memory-bank/ ← Manually updated
.roo/memory-bank/ ← No search capability
The Problem with Native Memory Banks:
- ❌ Manual Maintenance: Agents must manually rewrite files to update memory.
- ❌ No Search: Agents must read entire files to find specific information.
- ❌ No Analytics: No way to track memory growth or patterns over time.
- ❌ Isolated: Memories are locked to a single project.
✅ The Solution: agentMemory
agentMemory fixes these limitations by upgrading your memory bank with:
.agentMemory/ ← Our structured database
├── Bi-directional sync ← Keeps their markdown updated
├── Powerful search ← Query by type, tags, content
├── Visual dashboard ← See trends and analytics
└── MCP tools ← Programmatic access for AI
Benefits:
- ✅ Automatic sync - No manual "update memory bank" needed
- ✅ Searchable - Find memories by query, type, or tags
- ✅ Visual dashboard - Charts, trends, and analytics
- ✅ Cross-project - Query memories across all your projects
- ✅ Compatible - Works WITH their systems, not against them
🏗️ How It Works: Hybrid Architecture
Two-Layer System
┌─────────────────────────────────────────────────────────┐
│ Built-In Memory Banks (Markdown Files) │
│ .kilocode/rules/memory-bank/ │
│ .clinerules/memory-bank/ │
│ .roo/memory-bank/ │
│ ├── Human-readable documentation │
│ ├── Git-committable │
│ └── Read automatically by agents at session start │
└──────────────┬──────────────────────────────────────────┘
│
│ ⬍ Bi-Directional Sync ⬊
│
┌──────────────▼──────────────────────────────────────────┐
│ agentMemory (Structured Storage + MCP Server) │
│ .agentMemory/ │
│ ├── JSON database for fast queries │
│ ├── MCP tools (memory_read, memory_search, etc.) │
│ ├── Dashboard with analytics │
│ └── Cross-project search capabilities │
└─────────────────────────────────────────────────────────┘
The Flow
1. Session Start - Passive Context Loading
AI reads markdown files (.kilocode/rules/memory-bank/)
└─> Contains: Project context + MCP usage instructions
└─> Sees: "This project uses agentMemory MCP tools"
2. During Session - Active Queries
AI needs to find auth patterns
└─> Calls: memory_search({ query: "auth pattern" })
└─> Gets: Structured results from our database
└─> Faster and more accurate than file scanning
3. After Work - Automatic Sync
AI calls: memory_write({ key: "new-feature", ... })
└─> We save to: .agentMemory/ (JSON database)
└─> We sync to: .kilocode/rules/memory-bank/product.md
└─> Next session: They see it in markdown automatically
✨ Key Features
🔄 Bi-Directional Sync
Markdown → MCP
- Parses existing memory bank files
- Imports sections as searchable memories
- Preserves human-friendly docs
MCP → Markdown
- Auto-generates markdown from MCP data
- Appends to appropriate files:
architecture.md← Architecture decisionssystemPatterns.md← Code patternstechContext.md← Tech stack choicesproductContext.md← Featuresprogress.md← Status tracking
� Powerful Search
// Search across ALL memories
memory_search({
query: "authentication",
type: "pattern",
tags: ["security"]
})
// Returns structured results from our database
// Much faster than scanning markdown files
📊 Visual Dashboard
- Memory trends over time
- Agent activity tracking
- Type distribution (architecture vs patterns vs features)
- Recent changes timeline
- Cross-project insights
🤖 Multi-Agent Support
| Agent | Memory Bank Location | Sync Status |
|---|---|---|
| KiloCode | .kilocode/rules/memory-bank/ |
✅ Full sync |
| Cline | .clinerules/memory-bank/ |
✅ Full sync |
| RooCode | .roo/memory-bank/ |
✅ Full sync |
Files Synced:
projectBrief.md/brief.mdarchitecture.md/systemPatterns.mdproductContext.md/product.mdtechContext.md/tech.mdactiveContext.md/context.mdprogress.mddecisionLog.md(RooCode)
📦 Installation
From Marketplace (1-Click)
- Open VS Code
- Extensions → Search "agentMemory"
- Click Install
- Reload VS Code
That's it! The extension will:
- ✅ Create MCP server configuration
- ✅ Inject memory-first instructions into memory banks
- ✅ Start bi-directional sync
- ✅ Enable dashboard
Manual Installation
git clone https://github.com/yourusername/agentMemory
cd agentMemory
npm install
npm run compile
npm run package
code --install-extension agentmemory-0.1.0.vsix
🎮 Usage
For End Users (Zero Config)
Once installed, agentMemory works automatically:
- Import existing memory banks on first run
- Sync new memories as agents create them
- Provide MCP tools for fast queries
- Update markdown files to keep agents in sync
No configuration needed!
For AI Agents (Automatic)
Agents will find mandatory instructions in their memory bank files:
# techContext.md
## agentMemory System (REQUIRED)
This project uses agentMemory for knowledge management.
### Required Workflow
1. Before ANY work: Call memory_search() to check existing knowledge
2. After ANY work: Call memory_write() to document decisions
3. Use memory_read() for specific pattern retrieval
Agents treat this as project architecture and follow it automatically.
🛠️ Memory Tools (MCP)
| Tool | Purpose | Example |
|---|---|---|
memory_write |
Save new memory | Document architecture decisions |
memory_read |
Get specific memory | Retrieve OAuth implementation |
memory_search |
Query by content/tags | Find all auth-related patterns |
memory_list |
List by type | Show all architecture decisions |
memory_update |
Modify existing | Append to existing pattern |
memory_stats |
View analytics | Usage statistics |
� Project Structure
After installation, your project will have:
your-project/
├── .vscode/
│ └── settings.json # MCP server config (auto-created)
│
├── .agentMemory/ # Our structured storage
│ ├── uuid-001.json # Memory: OAuth architecture
│ ├── uuid-002.json # Memory: API patterns
│ └── ...
│
├── .kilocode/rules/memory-bank/ # KiloCode memory bank
│ ├── brief.md # ⬍ Synced with our database
│ ├── architecture.md # ⬍ Auto-updated
│ ├── product.md # ⬍ Auto-updated
│ └── tech.md # ⬍ Auto-updated
│
├── .clinerules/memory-bank/ # Cline memory bank
│ ├── projectBrief.md # ⬍ Synced
│ ├── systemPatterns.md # ⬍ Synced
│ └── ... # ⬍ Synced
│
└── .roo/memory-bank/ # RooCode memory bank
├── projectBrief.md # ⬍ Synced
├── decisionLog.md # ⬍ Synced
└── ... # ⬍ Synced
All markdown files stay human-readable and git-friendly!
💡 Example Workflow
Day 1: Initial Implementation
User → KiloCode: "Create OAuth authentication"
- KiloCode implements OAuth
- Calls:
memory_write({ key: "oauth-impl", type: "architecture", ... }) - agentMemory saves to:
.agentMemory/uuid-001.json(our database).kilocode/rules/memory-bank/architecture.md(their markdown)
Day 3: Extension by Different Agent
User → Cline: "Add Google OAuth provider"
- Cline reads
.clinerules/memory-bank/architecture.md - Sees OAuth documentation (synced from our database)
- Calls:
memory_search({ query: "oauth" }) - Gets structured results instantly
- Implements Google provider consistently
Day 7: New Developer Onboarding
New Dev → RooCode: "How does authentication work?"
- RooCode reads
.roo/memory-bank/systemPatterns.md - Sees complete auth patterns (auto-synced)
- Calls:
memory_read({ key: "oauth-impl" }) - Gets full OAuth architecture doc
- ✅ Instant understanding - Zero learning curve
🎯 Why agentMemory?
| Feature | agentMemory | Built-In Banks | Standalone MCP |
|---|---|---|---|
| Markdown Files | ✅ Synced | ✅ Manual | ❌ No |
| Search | ✅ Fast indexed | ❌ No | ✅ Yes |
| Analytics | ✅ Dashboard | ❌ No | ❌ No |
| Automation | ✅ Auto-sync | ❌ Manual | ⚠️ Partial |
| Multi-Agent | ✅ All 3 | ✅ Per-agent | ✅ All |
| Git-Friendly | ✅ Yes | ✅ Yes | ⚠️ Depends |
| Cross-Project | ✅ Yes | ❌ No | ❌ No |
� Dashboard
Opening Dashboard
Cmd/Ctrl+Shift+P → "agentMemory: Open Memory Dashboard"
Features
- Overview: Total memories, active agents, recent activity
- Charts: Memory types, agent activity, trends over time
- Search: Query memories with filters
- Export: Generate markdown summaries
- Sync Status: See which files are synced
� Privacy & Security
- ✅ 100% Local - No cloud storage
- ✅ Offline-First - Works without internet
- ✅ Git-Friendly - Commit
.agentMemory/to version control - ✅ Open Source - Audit the code yourself
🤝 Contributing
Contributions welcome! See CONTRIBUTING.md
📄 License
MIT © Amit Rathiesh (Webzler Solutions Inc.)
👨💻 Author
Amit Rathiesh
Webzler Solutions Inc.
📧 amitrathiesh@webzler.com
🌐 www.webzler.com
🐙 @amitrathiesh
agentMemory MCP 질문
agentMemory MCP는 어떤 도구를 제공하나요?
6개 도구를 제공합니다. 예: memory_write, memory_read, memory_search, memory_list, memory_update.
agentMemory가 AI 코딩 에이전트에게 어떤 역할을 하나요?
검색 가능한 MCP 도구를 사용하여 에이전트의 기억을 로컬 JSON 데이터베이스에 저장하며, 이를 KiloCode, Cline, RooCode에서 사용하는 기존 memory bank markdown 파일과 동기화합니다.
agentMemory는 어떤 MCP 도구를 제공하나요?
memory_write, memory_read, memory_search, memory_list, memory_update, memory_stats를 제공합니다.
agentMemory를 사용하려면 별도의 설정이 필요한가요?
확장 프로그램이 MCP server 설정을 생성하고 memory-first 지침을 자동으로 주입하므로 수동 설정이 필요하지 않습니다.
agentMemory 데이터는 클라우드에 저장되나요?
아니요, 모든 데이터는 로컬에 저장되며 오프라인으로 작동합니다. .agentMemory 디렉토리는 버전 관리 시스템에 커밋할 수 있습니다.
agentMemory는 어떤 에이전트와 동기화되나요?
KiloCode, Cline, RooCode의 memory bank와 완전히 동기화됩니다.