agent-memory-mcp は何をしますか?
AIエージェント向けの永続的かつ検索可能な知識管理(アーキテクチャ、パターン、決定事項)を提供するハイブリッドメモリシステム。
このスキルは、Model Context Protocol (MCP) を介してAIアシスタント(Claude Code、Cursor、Codexなど)がセッションを超えて重要な知識を保存・取得できるようにします。
機能
- 永続メモリ: エージェントのセッション間で知識を保持します。
- セマンティック検索: 保存されたメモリに対して自然言語で検索できます。
- 階層構造: メモリをカテゴリ(例:アーキテクチャ、パターン、決定事項)で整理できます。
- 動的更新: 既存のメモリの追加、編集、削除が可能です。
- MCP統合: 標準プロトコルにより幅広いエージェントプラットフォームと互換性があります。
クイックスタート
前提条件
- Node.js 18以降
- 互換性のあるMCPクライアント(Claude Code、Cursor、Codexなど)
インストール
npm install -g sickn33/agent-memory-mcp
または、プロジェクトの依存関係として追加します:
npm install sickn33/agent-memory-mcp
設定
環境変数を設定するか、設定ファイルを作成します:
MEMORY_PATH=./memories
使い方
MCPクライアントでこのスキルを有効にした後、以下のコマンドを使用できます:
remember <内容>: 新しいメモリを保存します。recall <クエリ>: 保存されたメモリを検索します。forget <id>: IDを指定してメモリを削除します。list: すべてのメモリを表示します。
例
> アーキテクチャの決定:マイクロサービスパターンを採用する
メモリが保存されました(ID: abc123)
> 以前のアーキテクチャの決定を忘れた場合
結果:ID abc123: アーキテクチャの決定:マイクロサービスパターンを採用する
設定
このスキルは、以下の設定オプションをサポートしています:
| オプション | 説明 | デフォルト |
|---|---|---|
MEMORY_PATH | メモリファイルを保存するディレクトリ | ./memories |
MEMORY_LIMIT | 保存されるメモリの最大数 | 1000 |
SEARCH_ALGORITHM | 検索に使用するアルゴリズム | semantic |
開発
git clone https://github.com/sickn33/agent-memory-mcp.git
cd agent-memory-mcp
npm install
npm run build
npm test
ライセンス
MIT
貢献
プルリクエストを歓迎します。大きな変更については、まずissueを開いて変更内容を議論してください。