本地Mem0 MCP服务器
一个完全自托管的模型上下文协议(MCP)服务器,集成了 Mem0 用于持久存储功能。使像Claude这样的人工智能助手能够在对话中存储和检索上下文信息。
✨ 特性
- 🧠 持久存储器:存储和检索对话中的记忆
- 🔒 完全自托管:没有外部API或云依赖关系
- 🐳 容器化:只需一个命令即可完成Docker部署
- 🚀 简易安装:Windows、Mac和Linux的单脚本设置
- 🤖 本地AI模型:将Ollama与phi3:mini和nomic嵌入文本一起使用
- 📊 矢量存储器:PostgreSQL和pgvector用于高效的内存搜索
- 🔌 MCP兼容:与Claude Desktop和其他支持MCP的AI工具配合使用
🚀 快速开始
先决条件
- 已安装并正在运行
- 克劳德桌面 (用于测试)
安装
窗户:
git clone https://github.com/Synapse-OS/local-mem0-mcp.git
cd local-mem0-mcp
install.batMac/Linux:
git clone https://github.com/Synapse-OS/local-mem0-mcp.git
cd local-mem0-mcp
chmod +x install.sh
./install.sh安装将:
- 构建MCP服务器容器
- 启动PostgreSQL和Ollama服务
- 下载AI模型(总计约2.5GB)
- 配置Claude桌面集成
- 测试安装
测试
安装和配置后:
- 重新启动克劳德桌面 完全(关闭并重新打开)
- 验证MCP服务器:类型
/mcp-应列出mem0-local现有 - 测试内存存储:“请记住,我今天正在测试MCP存储系统”
- 测试内存检索“你还记得我什么?”
- 验证持久性:重新启动Claude Desktop并再次询问-记忆应该持续存在
MCP连接故障排除:
- 如果
/mcp未显示服务器,请检查配置文件路径和JSON语法 - 确保Docker容器正在运行:
docker ps - 检查MCP服务器日志:
docker logs mem0-mcp-server
🏗️ 建筑
┌─────────────────┐ ┌──────────────────┐ ┌─────────────────┐
│ Claude │ │ MCP Server │ │ PostgreSQL │
│ Desktop │◄──►│ (FastMCP) │◄──►│ + pgvector │
└─────────────────┘ └──────────────────┘ └─────────────────┘
│
▼
┌──────────────────┐
│ Ollama │
│ phi3:mini + │
│ nomic-embed-text │
└──────────────────┘🔧 配置
Claude桌面MCP配置
安装后,配置Claude Desktop以使用MCP服务器:
窗户: 编辑 %APPDATA%\Claude\claude_desktop_config.json:
雨衣: 编辑 ~/Library/Application Support/Claude/claude_desktop_config.json:
Linux: 编辑 ~/.config/Claude/claude_desktop_config.json:
添加此配置:
{
"mcpServers": {
"mem0-local": {
"command": "docker",
"args": [
"exec", "-i", "mem0-mcp-server",
"python", "/app/src/server.py"
]
}
}
}系统配置
系统默认配置为本地操作:
- MCP服务器:使用STDIO传输在Docker容器中运行
- 数据库:PostgreSQL,端口5432上有pgvector
- AI模型:端口11434上的本地Ollama实例
- 记忆存储:带有向量嵌入的用户隔离记忆
📋 可用内存操作
- add_memory:存储新的记忆
- 搜索_存储:通过查询查找相关记忆
- 获取所有记忆:检索用户的所有记忆
- update_memory:修改现有内存
- 删除记忆:删除特定记忆
- 删除所有记忆:清除用户的所有记忆
- get_memory_stats:获取内存统计信息
🔍 故障排除
检查服务:
docker ps查看日志:
docker-compose -f docker-compose.local.yml logs重新启动服务:
docker-compose -f docker-compose.local.yml restart干净重启:
docker-compose -f docker-compose.local.yml down -v
# Run install script again🤝 贡献
欢迎投稿!请随时提交拉取请求。
📄 许可证
此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。
