基本能力
产品定位
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
使用教程
使用依赖
```bash
Install UV if not already installed
pip install uv
```
安装教程
```bash
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安装
```bash
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
```
调试方式
- 检查Claude Desktop控制台是否有错误消息
- 验证Docker是否有访问挂载目录的必要权限
- 确保Docker容器以正确的参数运行
- 尝试手动运行容器以查看错误输出
- 测试记忆功能:
- 让Claude记住一些事情:"请记住我最喜欢的颜色是蓝色"
- 稍后或在新的对话中询问:"我最喜欢的颜色是什么?"
- Claude应该从记忆服务中检索信息