用于Claude桌面应用的大语言模型持久内存服务器——Claude Memory MCP Server

概述

该项目实现了一种基于广泛研究的优化记忆技术，为大型语言模型提供持久内存功能，并专门与Claude桌面应用程序集成。

功能

• 分层内存架构：短期、长期和存档内存层级
• 多种内存类型：支持对话、知识、实体和反思
• 语义搜索：基于语义相似性检索记忆
• 内存巩固：自动将短期记忆合并到长期记忆中
• 内存管理：基于重要性的记忆保留与遗忘
• Claude集成：可以直接用于Claude桌面应用程序
• MCP协议支持：与Model Context Protocol兼容

架构

MCP服务器采用功能域-based架构，包含以下组件：

┌─────────────────────────────────────────────────────────┐
│                   Claude 桌面                        │
└───────────────────────────┬─────────────────────────────┘
                            │
┌───────────────────────────▼─────────────────────────────┐
│                     MCP 接口                       │
│  ┌─────────────────┐  ┌─────────────────┐  ┌──────────┐ │
│  │ 工具定义         │  │ 请求处理程序     │  │ 安全性   │ │
│  └─────────────────┘  └─────────────────┘  └──────────┘ │
└───────────────────────────┬─────────────────────────────┘
                            │
┌───────────────────────────▼─────────────────────────────┐
│                内存域管理器                    │
├─────────────────┬─────────────────┬────────────────────┤
│  连篇记忆领域   │  语义领域       │  时间领域          │
├─────────────────┴─────────────────┴─────────────────────┤
└                                                ┓

安装步骤

1. 克隆仓库：

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

2. 安装依赖项：

pip install -r requirements.txt

3. 启动服务器：

python mcp/server.py

与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"
        }
    ]
}

使用说明

运行服务器

python mcp/server.py

可用工具

• 查询内存：query_memory
• 更新内存：update_memory
• 删除内存条目：delete_memory_entry

项目结构

claude-memory-mcp-server/
├── mcp/
│   ├── server.py          # MCP服务器实现
│   ├── tools.py           # MCP工具定义
│   └── handler.py         # 请求处理程序
├── security/
│   └── validation.py      # 输入验证
└── utils/
    ├── embeddings.py      # 向量嵌入工具
    └── schema.py          # 架构验证

运行测试

pytest

研究背景

本实现基于广泛研究的大型语言模型持久记忆技术：

• 操作系统启发式内存管理：类似MemGPT的分层内存架构
• 生物启发式连篇记忆：上下文敏感的记忆检索
• 向量嵌入：语义搜索灵感来自向量数据库方法
• 自我反思：通过定期回顾实现记忆巩固

贡献指南

欢迎贡献！请随意提交Pull Request。

许可证

本项目在MIT License下开源，详情请参阅LICENSE文件。

致谢

• 基于大型语言模型优化内存技术的研究
• 实现Model Context Protocol以与Claude集成