MCP Memory Service

MCP Memory Service

使用ChromaDB和句子转换器为Claude提供语义内存和持久存储能力的MCP服务器。

GitHub
Created Bydoobidoodoobidoo

简介

MCP 内存服务为 Claude Desktop 提供语义记忆和持久存储功能，使用 ChromaDB 和句子转换器技术。支持语义搜索、基于时间和标签的记忆检索，适用于各种平台。

安装

# 克隆仓库
git clone https://github.com/doobidoo/mcp-memory-service.git
cd mcp-memory-service

# 创建并激活虚拟环境
python -m venv venv
source venv/bin/activate  # 在 Windows 上：venv\Scripts\activate

# 运行安装脚本
python install.py

Windows 用户注意：如遇安装问题，请使用 python scripts/install_windows.py

Claude MCP 配置

将以下内容添加到 claude_desktop_config.json 文件中：

{
  "memory": {
    "command": "uv",
    "args": [
      "--directory",
      "your_mcp_memory_service_directory",
      "run",
      "memory"
    ],
    "env": {
      "MCP_MEMORY_CHROMA_PATH": "your_chroma_db_path",
      "MCP_MEMORY_BACKUPS_PATH": "your_backups_path"
    }
  }
}

核心功能

  • 记忆存储：保存包含标签的新信息
  • 语义检索：通过相关性查找记忆内容
  • 时间回忆：使用自然语言时间表达式检索记忆
  • 标签搜索：基于标签查找记忆
  • 精确匹配：查找完全匹配的内容
  • 数据库管理：备份、优化、健康监控

主要操作

# 存储记忆
store_memory(content="重要信息", tags=["工作", "会议"])

# 检索相关记忆
retrieve_memory(query="关于项目的讨论", limit=5)

# 基于时间回忆
recall_memory(time_expression="上周", query="会议内容")

# 按标签搜索
search_by_tag(tag="工作")

配置选项

通过环境变量自定义服务行为：

CHROMA_DB_PATH: 数据库存储路径
BACKUP_PATH: 备份存储路径
AUTO_BACKUP_INTERVAL: 备份间隔（小时，默认值：24）
SIMILARITY_THRESHOLD: 相似度阈值（默认值：0.7）
MAX_RESULTS_PER_QUERY: 每次查询最大结果数（默认值：10）

硬件兼容性

支持多种平台和加速器：

  • Apple Silicon (M1/M2/M3) 通过 MPS
  • 英特尔/AMD 处理器
  • CUDA、DirectML 和 ROCm 加速器
  • 所有平台的 CPU 回退支持

测试

# 安装测试依赖
pip install pytest pytest-asyncio

# 运行所有测试
pytest tests/

# 快速测试服务器
python scripts/run_memory_server.py

完整文档请参阅 安装指南。