agentMemory MCPサーバー
コミット 2026年10月21日AIコーディングエージェントに対し、KiloCode、Cline、RooCodeのメモリバンク用Markdownファイルと同期可能な、検索可能なローカルメモリ保存領域を提供します。
別名 webzler/agentMemory
- スター
- 33
- ツール
- 6
- ダウンロード数(30日間)
- —
- 最新バージョン
- —
- 最終コミット
- 2026年10月21日
- ライセンス
- MIT
agentMemory MCPとは
agentMemoryはMCPサーバーです。 AIコーディングエージェントに対し、KiloCode、Cline、RooCodeのメモリバンク用Markdownファイルと同期可能な、検索可能なローカルメモリ保存領域を提供します。. 6個のツールを提供しており、memory_write, memory_read, memory_searchなどがあります。
プロジェクトのREADMEから生成された概要
agentMemory MCP server について
agentMemoryの主な機能は、AIコーディングエージェントに検索可能で永続的なメモリ保存領域を提供することです。手動によるMarkdownドキュメントと構造化データの間のギャップを埋めることで、KiloCode、Cline、RooCodeを使用する開発者を支援します。このシステムは、ローカルのJSONデータベースと、これらの特定のコーディングツールで使用されている既存のMarkdownメモリバンクとの間で双方向の同期を維持するハイブリッドアーキテクチャを採用しています。
ユーザーは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で使用されている既存のメモリバンク用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のメモリバンクと完全に同期します。