Memory Plus

Memory-Plus

MCP エージェント向けの軽量なローカル Retrieval-Augmented Generation（RAG）メモリストアです。Memory-Plus を使うと、エージェントは実行をまたいで、メモ、アイデア、セッションのコンテキストなどの永続的な「メモリー」を記録、取得、更新、可視化できます。

🏆 Infosys Cambridge AI Centre Hackathonで第1位を獲得しました！

主な機能

• メモリーの記録：ユーザーデータ、アイデア、重要なコンテキストを保存します。
• メモリーの取得：過去のエントリーをキーワードやトピックで検索します。
• 最近のメモリー：直近のN件をすばやく取得します。
• メモリーの更新：既存のエントリーにシームレスに追記、または変更します。
• メモリーの可視化：関連性を明らかにするインタラクティブなグラフクラスターを表示します。
• ファイルのインポート（v0.1.2以降）：ドキュメントをメモリーに直接取り込みます。
• メモリーの削除（v0.1.2以降）：不要なエントリーを削除します。
• メモリーのためのメモリー（v0.1.4以降）：resourcesを使って、過去のやり取りをいつ想起するか（また、いつ想起しないか）をAIに正確に教えます。
• メモリーのバージョン管理（v0.1.4以降）：メモリーが更新されると、完全な履歴を提供できるよう、古いバージョンを保持します。

インストール

1. 前提条件

Google API キー Google AI Studioから取得し、環境内でGOOGLE_API_KEYとして設定してください。

このAPIキーはGemini Embedding APIにのみ使用するため、完全に無料でご利用いただけます！

# macOS/Linux
export GOOGLE_API_KEY="<YOUR_API_KEY>"

# Windows (PowerShell)
setx GOOGLE_API_KEY "<YOUR_API_KEY>"

UV ランタイム MCP プラグインの提供に必要です。

pip install uv

# macOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# Windows (PowerShell)
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

VS Code ワンクリックセットアップ

以下のバッジをクリックすると、Memory-Plus が VS Code に自動的にインストールされ、設定されます。

これにより、以下がsettings.jsonに追加されます。

  {
    "mcpServers": {
      //...,  your other MCP servers
      "memory-plus": {
        "command": "uvx",
        "args": [
          "-q",
          "memory-plus@latest"
        ],
      }
    }
  }

cursorの場合は、file -> Preferences -> Cursor Settings -> MCPに移動し、上記の設定を追加してください。 GOOGLE_API_KEYをシークレット／環境変数に追加していない場合は、次の設定を追加できます。

"env": {
        "GOOGLE_API_KEY": "<YOUR_API_KEY>"
      }

memory-plusディクショナリ内のargs配列の直後に追加してください。

Clineの場合は、以下をcline_mcp_settings.jsonに追加してください。

{
  "mcpServers": {
    //...,  your other MCP servers
    "memory-plus": {
      "disabled": false,
      "timeout": 300,
      "command": "uvx",
      "args": [
        "-q",
        "memory-plus@latest"
      ],
      "env": {
        "GOOGLE_API_KEY": "${{ secrets.GOOGLE_API_KEY }}"
      },
      "transportType": "stdio"
    }
  }
}

その他のIDEでも、ほぼ同様の手順で設定できます。

ローカルでのテストと開発

MCP Inspector を使って、memory-plus サーバーをローカルでテストできます。

git clone https://github.com/Yuchen20/Memory-Plus.git
cd Memory-Plus
npx @modelcontextprotocol/inspector fastmcp run run .\\memory_plus\\mcp.py

または、このMCPを実際のチャットセッションで使いたい場合は、agent.pyにチャットボットのテンプレートがあります。

# Clone the repository
git clone https://github.com/Yuchen20/Memory-Plus.git
cd Memory-Plus

# Install dependencies
pip install uv
uv pip install fast-agent-mcp
uv run fast-agent setup        

fastagent.config.yamlとfastagent.secrets.yamlを、ご自身のAPIキーで設定してください。

# Run the agent
uv run agent_memory.py

ロードマップ

• メモリーの更新
• メモリー記録のプロンプトエンジニアリングの改善
• メモリーグラフの可視化の改善
• ファイルのインポート
• リモートバックアップ！
• メモリー管理用のウェブ UI

機能のリクエストがある場合は、新しいイシューを作成するか、機能リクエストに新しい項目を追加してください。

ライセンス

このプロジェクトは Apache License 2.0 の下でライセンスされています。詳細については LICENSE を参照してください。

FAQ

1. memory-plus が動作しないのはなぜですか？

• memory-plus には、初回のダウンロードに時間がかかる場合がある依存関係がいくつかあります。必要なものをすべて取得するには、通常約 1 分かかります。
• 依存関係をインストールすると、次回以降の使用は大幅に速くなります。
• ほかの問題が発生した場合は、お気軽にリポジトリで新しい issue を作成してください。

2. 実際のチャットセッションで memory-plus を使うにはどうすればよいですか？

• MCP の設定に MCP JSON ファイルを追加するだけです。
• 追加すると、必要に応じて memory-plus が自動的に有効になります。