🚀 Claude 内存 MCP 服务器

本项目是一个为大型语言模型提供持久内存功能的 MCP（模型上下文协议）服务器实现，专为集成到 Claude 桌面应用程序而设计。它为 Claude 提供了标准化方式来维护对话和会话间的持续内存，解决了大型语言模型在记忆管理方面的难题，提升了模型使用的连贯性和效率。

🚀 快速开始

安装

pip install .

Claude 集成

将以下内容添加到 claudia.json：

{
    "mcp_server": {
        "host": "localhost",
        "port": 1234,
        "api_key": "your_api_key"
    }
}

运行

python -m mcp.server

运行测试

pytest

✨ 主要特性

• 分层存储架构：具备短期、长期和存档内存层级，满足不同场景下的记忆需求。
• 多种记忆类型：支持对话、知识、实体和反思等多种记忆类型，丰富了记忆的维度。
• 语义搜索：可基于语义相似性检索记忆，提高记忆检索的准确性。
• 内存巩固：能自动将短期记忆合并到长期记忆，确保重要信息的长期保存。
• 内存管理：基于重要性进行记忆的保留和遗忘，优化内存使用。
• Claude 集成：可直接与 Claude 桌面应用程序集成，方便快捷。
• MCP 协议支持：兼容模型上下文协议，具有良好的通用性。

🔧 技术细节

架构

MCP 服务器遵循功能性领域基于架构，包含以下组件：

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

研究背景

此实现基于对当前 LLM 持久记忆技术的全面研究：

• OS 启发式内存管理：类似于 MemGPT 的分层存储架构。
• 生物启发式连锁记忆：实现上下文敏感的记忆检索。
• 向量嵌入：语义搜索受到向量数据库方法的启发。
• 自我反思：通过定期回顾进行记忆巩固。

📄 许可证

本项目在 MIT 许可证下，详情请参阅 LICENSE 文件。

致谢

• 基于对 LLM 优化记忆技术的研究。
• 实现模型上下文协议以与 Claude 集成。

贡献

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