本地记忆服务

一个完全自托管的模型上下文协议(MCP)服务器,集成了Mem0以实现持久记忆功能,使AI助手能够跨对话存储和检索上下文信息。

  • by Hroerkr
  • PowerShell
  • 本地部署
  • 4 星标
  • 更新于
在 GitHub 查看 Hroerkr/mem0mcp

使用说明

本地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.bat

Mac/Linux:

git clone https://github.com/Synapse-OS/local-mem0-mcp.git
cd local-mem0-mcp
chmod +x install.sh
./install.sh

安装将:

  1. 构建MCP服务器容器
  2. 启动PostgreSQL和Ollama服务
  3. 下载AI模型(总计约2.5GB)
  4. 配置Claude桌面集成
  5. 测试安装

测试

安装和配置后:

  1. 重新启动克劳德桌面 完全(关闭并重新打开)
  2. 验证MCP服务器:类型 /mcp -应列出 mem0-local 现有
  3. 测试内存存储:“请记住,我今天正在测试MCP存储系统”
  4. 测试内存检索“你还记得我什么?”
  5. 验证持久性:重新启动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许可证获得许可-请参阅 许可证 文件以获取详细信息。

🙏 致谢