MCP Memory Service

基本能力

产品定位

MCP Memory Service 是一个专注于语义记忆和持久存储的MCP服务器，旨在为Claude Desktop提供长期记忆存储和语义搜索能力。

核心功能

• 使用句子转换器进行语义搜索
• 基于自然语言的时间回忆（如"上周"、"昨天早上"）
• 基于标签的记忆检索系统
• 使用ChromaDB进行持久存储
• 自动数据库备份
• 记忆优化工具
• 精确匹配检索
• 用于相似性分析的调试模式
• 数据库健康监控
• 重复检测和清理
• 可定制的嵌入模型
• 跨平台兼容性（Apple Silicon、Intel、Windows、Linux）
• 针对不同环境的硬件感知优化
• 有限硬件资源的优雅回退

适用场景

• 在Claude Desktop中保持对话上下文
• 长期记忆存储和检索
• 基于语义的记忆搜索
• 跨平台记忆服务

工具列表

• UV：用于虚拟环境管理和包安装
• Docker：用于容器化部署
• ChromaDB：向量数据库
• Sentence Transformers：嵌入模型

常见问题解答

• 安装问题：确保正确安装UV和Docker
• 路径问题：确保Docker有正确的文件共享权限
• 硬件兼容性问题：检查硬件兼容性表
• 配置问题：正确配置claude_desktop_config.json

使用教程

使用依赖

# Install UV if not already installed
pip install uv

安装教程

# Clone and install
git clone https://github.com/doobidoo/mcp-memory-service.git
cd mcp-memory-service
uv venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate
uv pip install -r requirements.txt
uv pip install -e .

# Run the service
uv run memory

Docker安装

# Build the Docker image
docker build -t mcp-memory-service .

# Run the container
docker run -it \
  -v $HOME/mcp-memory/chroma_db:/app/chroma_db \
  -v $HOME/mcp-memory/backups:/app/backups \
  mcp-memory-service

调试方式

1. 检查Claude Desktop控制台是否有错误消息
2. 验证Docker是否有访问挂载目录的必要权限
3. 确保Docker容器以正确的参数运行
4. 尝试手动运行容器以查看错误输出
5. 测试记忆功能：
6. 让Claude记住一些事情："请记住我最喜欢的颜色是蓝色"
7. 稍后或在新的对话中询问："我最喜欢的颜色是什么？"
8. Claude应该从记忆服务中检索信息

许可证

该项目遵循 MIT 开源许可条款。