Memory Graph

🚀 使用 Redis 圖數據庫的 MCP 內存系統

該項目實現了一個用於 LLM 對話的記憶存儲系統，藉助 Redis Graph 完成長期記憶的存儲，為 LLM 對話提供高效、可靠的記憶管理方案。

🚀 快速開始

本項目旨在實現一個用於 LLM 對話的記憶存儲系統，使用 Redis Graph 進行長期記憶存儲。下面將為你介紹該項目的安裝和使用方法。

✨ 主要特性

• 存儲記憶：將對話中的關鍵信息持久化到 Redis 圖數據庫。
• 檢索能力：支持根據 ID、類型和內容快速查找記憶。
• 關聯關係：允許建立記憶之間的關聯，便於複雜查詢和分析。
• 支持多種記憶類型：涵蓋普通記憶、Finance 類型、技術問題等，適用於不同場景。

📦 安裝指南

先決條件

• 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'
});

📚 詳細文檔

支持的記憶類型

• 普通記憶：通用類型，適用於各種場景。
• 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 內存系統的功能、安裝方法和使用場景。如需進一步瞭解詳細技術細節或進行實際部署，請參考相關文檔和技術支持資源。