Memcp

🚀 MemCP - AI代理內存協議中的記憶上下文協議

MemCP 是一個模塊化且可擴展的AI代理內存 MCP 服務器，專為 IDE 或支持 MCP 的 LLM 客戶端應用程序打造。它基於 Zep AI Graphiti 裡的 mcp-server 示例進行拓展，能讓 AI 代理構建、維護並查詢一個會隨新信息自動演變的時序知識圖譜。

🚀 快速開始

MemCP 目前設計為即插即用型內存服務器，適用於任何支持本地 SSE 或標準輸入輸出（stdio）傳輸的 IDE 或 LLM 客戶端應用程序。

⚠️ 重要提示

它主要與 Cursor IDE 進行了測試，與其他支持MCP 的客戶端相比可能有不同的表現。

✨ 主要特性

• 時序知識圖譜：允許AI代理自動構建和查詢一個隨時間演化的知識圖譜
• MCP 集成：與任何支持MCP的客戶端兼容
• 實體提取：自動提取代碼特定的實體及其關係，定製化功能即將推出
• 靈活配置：可通過環境變量、TOML 文件或命令行參數配置
• 持久性存儲：使用 Neo4j 存儲知識，實現跨會話持久化
• 多傳輸支持：同時支持 SSE（HTTP）和 stdio 傳輸

📚 詳細文檔

完整的 MemCP 文檔位於 docs 目錄。請查閱 docs/README.md 獲取更多信息。

📦 安裝指南

環境要求

• 操作系統：Linux、macOS 或 Windows（建議使用 Linux）
• 編程語言：Python 3.8+
• 依賴管理工具：pip（推薦）

安裝步驟

1. 克隆倉庫：

git clone https://github.com/your-repository/memcp.git
cd memcp

2. 安裝依賴：

pip install -r requirements.txt

3. 配置環境變量（可選）：
   • 設置 NEO4J_URI 指定數據庫連接地址
   • 設置 NEO4J_USER 和 NEO4J_PASSWORD 用於身份驗證
   • 設置 OPENAI_API_KEY 或 ANTHROPIC_API_KEY 進行實體提取

啟動服務

python3 memcp_server.py

💻 使用示例

基礎用法

# 初始化 MemCP 實例
from memcp import MemCP
mem = MemCP()

# 添加知識片段
mem.add_fact("用戶偏好", "喜歡紅色")

# 查詢知識圖譜
print(mem.get_facts())

高級用法

實體類型

MemCP 定義了以下默認實體類型：

• Preference：用戶的喜好和傾向
• Procedure：執行特定任務的步驟或操作
• Requirement：產品或服務必須滿足的功能需求

通過 --graph.use_memcp_entities 標誌可啟用/禁用這些實體類型。

持久化存儲

MemCP 使用 Neo4j 數據庫進行數據持久化。默認情況下，數據會自動保存到本地實例中。如需配置自定義數據庫地址，請設置環境變量：

export NEO4J_URI=bolt://localhost:7687

🤝 貢獻指南

歡迎貢獻！請查閱 CONTRIBUTING.md 獲取具體指南。

📄 許可證

MemCP 採用 MIT 許可證，具體內容請參閱 LICENSE 文件。

⚠️ 重要提示

MemCP 的 API 調用頻率較高，因為它依賴的 Graphiti 也是如此。這意味著雖然能生成準確有用的知識圖譜，但也會產生較高的調用成本。使用時請注意控制調用次數以避免費用過高。