Memory Graph

🚀 Redis グラフデータベースを使用した MCP メモリシステム

このプロジェクトは、LLM 対話用のメモリストレージシステムを実装しており、長期的なメモリストレージに Redis Graph を使用しています。

📦 インストール

前提条件

• Docker と Docker Compose
• Node.js（v16 以上）

Redis と RedisGraph モジュールの起動

1. Docker Compose を使用して Redis コンテナを起動し、RedisGraph モジュールを読み込みます。

docker-compose up -d

2. Redis が正常に動作し、RedisGraph モジュールが読み込まれていることを確認します。

docker exec -it mcp-memory-redis-1 redis-cli

Redis CLI に入った後、以下のコマンドでモジュール情報を確認できます。

MODULE LIST

🚀 クイックスタート

メモリ管理ツール

• メモリの作成：createMemory メソッドを使用して、新しいメモリをデータベースに保存します。
• メモリの検索：getMemory メソッドを通じて、ID を基に特定のメモリを取得します。
• メモリの検索：searchMemories メソッドを利用して、キーワードまたは条件に基づいて関連するメモリを検索します。

基本的な使用法

// 新しい Finance タイプのメモリを作成する
await memoryService.createMemory({
  type: 'Finance',
  title: '信用卡政策更新',
  content: '新信用卡政策将在下月生效。',
  tags: ['信用卡', '金融政策']
});

// ID を基にメモリを検索する
const financeMemory = await memoryService.getMemory('12345');

// "debit card" 関連のすべての Finance タイプのメモリを検索する
const debitCardMemories = await memoryService.searchMemories({
  type: 'Finance',
  contentContains: 'debit card'
});

📚 ドキュメント

主な機能

• メモリの保存：対話中の重要な情報を Redis グラフデータベースに永続化します。
• 検索機能：ID、タイプ、内容に基づいてメモリを迅速に検索できます。
• 関連関係：メモリ間の関連を設定でき、複雑なクエリと分析を容易にします。

サポートされるメモリタイプ

• 通常のメモリ：汎用タイプで、様々なシナリオに適しています。
• Finance タイプ：金融関連の分野、政策や取引記録などに特化しています。
• 技術的な問題：プログラミングやシステム関連の議論内容を扱います。

データ保存構造

• ノード（Nodes）：各メモリはグラフデータベースのノードに対応し、タイプ、タイトル、内容、タグなどの属性を含みます。
• 関係（Relationships）：異なるメモリ間の関連を表し、「関連する」、「参照する」、「影響する」などがあります。

サンプルクエリコマンド

# すべてのグラフデータベースをリストする
GRAPH.LIST

# ノードの総数をカウントする
GRAPH.QUERY memory "MATCH (n) RETURN count(n)"

# Finance タイプのメモリをクエリする
GRAPH.QUERY memory "MATCH (n:Finance) RETURN n.id, n.title, n.content"

# 特定の内容を検索する
GRAPH.QUERY memory "MATCH (n) WHERE n.content CONTAINS 'debit card' RETURN n.id, n.type, n.content"

# ノードの関連関係を表示する
GRAPH.QUERY memory "MATCH (a)-[r]->(b) RETURN a.id, type(r), b.id"

Docker での実行方法

# ローカルでイメージをビルドする
docker build -t mcp/memory .

# コンテナを起動する（Redis が同じネットワークで動作していると仮定）
docker run --rm -i --network=mcp-memory_default -e REDIS_URL=redis://redis:6379 mcp/memory

テスト方法

# Redis 接続をテストする
npm run test:redis

# 基本的なメモリ操作をテストする
npm run test:memory

# 完全なサービス機能をテストする
npm run test:service

以上の内容を通じて、MCP メモリシステムの機能、インストール方法、使用シナリオを全面的に理解できます。詳細な技術情報や実際のデプロイについては、関連ドキュメントと技術サポートリソースを参照してください。