MCP Mem

🚀 MCP 內存

MCP 內存是一個模型上下文協議（MCP）服務器，專為數據豐富的應用程序提供內存解決方案。它藉助高效的圖知識圖譜 capabilities 管理內存，能從多個來源獲取信息，有效提升應用程序的性能和數據處理能力。

🚀 快速開始

MCP 服務器為涉及從多個來源（包括上傳文件）獲取信息的數據豐富的應用程序實現了內存解決方案。它使用 HippoRAG 在內部管理內存，HippoRAG 是此包的必需依賴項。

✨ 主要特性

• 基於會話的內存：創建和管理特定聊天會話的內存。
• 高效的知識圖譜：使用 HippoRAG 進行內存管理。
• 多種傳輸支持：與 stdio 和 SSE 傳輸兼容。
• 搜索功能：從各種來源（包括上傳文件）搜索信息。
• 自動資源管理：基於 TTL 的清理，適用於會話和內存實例。

📦 安裝指南

從 PyPI 安裝

pip install mcp-mem hipporag

從源代碼安裝

git clone https://github.com/ddkang1/mcp-mem.git
cd mcp-mem
pip install -e .
pip install hipporag

⚠️ 重要提示

HippoRAG 是 mcp-mem 正常運行的必需依賴項。

💻 使用示例

基本用法

可以直接運行 MCP 服務器，默認使用 stdio 傳輸：

mcp-mem

高級用法

使用 SSE 傳輸

mcp-mem --sse

指定 SSE 傳輸的主機和端口

mcp-mem --sse --host 127.0.0.1 --port 3001

📚 詳細文檔

基本配置

要在 Windsurf 中與 Claude 結合使用此工具，請將以下配置添加到 MCP 配置文件中：

"memory": {
    "command": "/path/to/mcp-mem",
    "args": [],
    "type": "stdio",
    "pollingInterval": 30000,
    "startupTimeout": 30000,
    "restartOnFailure": true
}

command 字段應指向您使用 pip 安裝 python 包的位置。

環境變量配置

可以通過環境變量配置 mcp-mem 所使用的 LLM 和嵌入式模型：

內存管理配置

• 會話 TTL：設置為 0 以禁用清理。默認值為 0。
• 實例 TTL：設置為 0 以禁用清理。默認值為 0。

提供的工具

• 創建內存：使用 create_memory 創建新的內存。
• 存儲內存：使用 store_memory 存儲內存。
• 檢索內存：使用 retrieve_memory 檢索內存。

🔧 技術細節

開發依賴安裝

要開發，請安裝以下依賴項：

pip install -r requirements.txt

運行測試

pytest tests/

代碼風格參考

black .
flake8 .
mypy .

🤝 貢獻

貢獻請遵循標準的開發流程，並在提交之前確保通過所有測試。

📄 許可證

項目採用 MIT License。