Claude Memory MCP

🚀 用於Claude桌面應用的大語言模型持久內存服務器——Claude Memory MCP Server

本項目為大型語言模型提供持久內存功能，藉助廣泛研究的優化記憶技術，專門與Claude桌面應用集成，有效解決了大語言模型在記憶管理方面的難題，提升了模型的應用效能。

✨ 主要特性

• 分層內存架構：具備短期、長期和存檔內存層級，實現高效的記憶管理。
• 多種內存類型：支持對話、知識、實體和反思等多種類型的記憶。
• 語義搜索：能夠基於語義相似性進行記憶檢索。
• 內存鞏固：可自動將短期記憶合併到長期記憶中。
• 內存管理：依據重要性對記憶進行保留與遺忘操作。
• Claude集成：可直接應用於Claude桌面應用程序。
• MCP協議支持：與Model Context Protocol兼容。

📦 安裝指南

1. 克隆倉庫：

git clone [repository-url]
cd claude-memory-mcp-server

2. 安裝依賴項：

pip install -r requirements.txt

3. 啟動服務器：

python mcp/server.py

💻 使用示例

基礎用法

運行服務器

python mcp/server.py

可用工具

• 查詢內存：query_memory
• 更新內存：update_memory
• 刪除內存條目：delete_memory_entry

高級用法

在Claude Desktop的配置文件中添加以下內容，以實現與Claude Desktop的集成：

{
    "mcp_server": {
        "host": "localhost",
        "port": 5000,
        "memory_file_path": "path/to/memory.json"
    }
}

📚 詳細文檔

內存文件結構

內存數據以JSON格式存儲，示例如下：

{
    "metadata": {
        "version": "1.0.0",
        "timestamp": "2023-10-26T12:00:00Z"
    },
    "memory_entries": [
        {
            "id": 1,
            "content": "今天天氣很好，我們去公園散步。",
            "context": ["weather", "park"],
            "timestamp": "2023-10-26T12:05:00Z"
        },
        {
            "id": 2,
            "content": "記得帶傘，下午可能下雨。",
            "context": ["weather", "umbrella"],
            "timestamp": "2023-10-26T12:10:00Z"
        }
    ]
}

項目結構

claude-memory-mcp-server/
├── mcp/
│   ├── server.py          # MCP服務器實現
│   ├── tools.py           # MCP工具定義
│   └── handler.py         # 請求處理程序
├── security/
│   └── validation.py      # 輸入驗證
└── utils/
    ├── embeddings.py      # 向量嵌入工具
    └── schema.py          # 架構驗證

運行測試

pytest

🔧 技術細節

MCP服務器採用功能域 - based架構，包含以下組件：

┌─────────────────────────────────────────────────────────┐
│                   Claude 桌面                        │
└───────────────────────────┬─────────────────────────────┘
                            │
┌───────────────────────────▼─────────────────────────────┐
│                     MCP 接口                       │
│  ┌─────────────────┐  ┌─────────────────┐  ┌──────────┐ │
│  │ 工具定義         │  │ 請求處理程序     │  │ 安全性   │ │
│  └─────────────────┘  └─────────────────┘  └──────────┘ │
└───────────────────────────┬─────────────────────────────┘
                            │
┌───────────────────────────▼─────────────────────────────┐
│                內存域管理器                    │
├─────────────────┬─────────────────┬────────────────────┤
│  連篇記憶領域   │  語義領域       │  時間領域          │
├─────────────────┴─────────────────┴─────────────────────┤
└                                                ┓

本實現基於廣泛研究的大型語言模型持久記憶技術：

• 操作系統啟發式內存管理：類似MemGPT的分層內存架構。
• 生物啟發式連篇記憶：上下文敏感的記憶檢索。
• 向量嵌入：語義搜索靈感來自向量數據庫方法。
• 自我反思：通過定期回顧實現記憶鞏固。

📄 許可證

本項目在MIT License下開源，詳情請參閱LICENSE文件。

致謝

• 基於大型語言模型優化內存技術的研究。
• 實現Model Context Protocol以與Claude集成。

貢獻指南

歡迎貢獻！請隨意提交Pull Request。