mcp-mem0 仓库中文介绍文档
mcp-mem0 是一个基于 Mem0 的长期代理内存 MCP 服务器,由 coleam00 提供,支持 AI 代理实现持久化记忆功能,汇聚了用于构建自定义 MCP 服务器的模板和示例。
要点:
- 这是一个用于为 AI 代理提供持久化记忆能力的 MCP 服务器模板
- 包含 Python 实现、Mem0 集成和实用配置示例
- 适合开发者快速构建自己的 MCP 服务器
一、核心信息速览
| 维度 |
详情 |
| :--- |
:--- |
| 仓库地址 |
[mcp-mem0](https://github.com/coleam00/mcp-mem0) |
| 许可证 |
MIT License |
| 核心定位 |
提供 AI 代理持久化记忆功能的 MCP 服务器模板 |
| 主要语言 |
Python |
| 适用人群 |
AI 开发者、MCP 服务器构建者、Mem0 用户 |
| 关键亮点 |
持久化记忆;语义搜索;与 Mem0 集成;可扩展性强 |
二、核心功能
| 功能模块 |
描述 |
典型场景 |
| :--- |
:--- |
:--- |
| save_memory |
将信息存储在长期记忆中,并使用语义索引进行管理 |
存储用户交互历史 |
| get_all_memories |
获取所有已存储的记忆以提供完整上下文 |
生成全面的对话历史 |
| search_memories |
使用语义搜索查找相关记忆 |
快速检索特定主题的信息 |
| 集成 Mem0 |
支持 Mem0 的长期记忆功能 |
扩展 AI 代理的能力 |
| 可配置性 |
支持多种 LLM 提供商和数据库 |
灵活适配不同环境 |
| Docker 支持 |
提供容器化部署方式 |
简化部署流程 |
| 多协议支持 |
支持 SSE 和 stdio 协议 |
增强兼容性 |
| 代码结构清晰 |
提供良好的代码组织和注释 |
便于开发和维护 |
三、快速上手
1. 环境准备
- Python 3.12+
- PostgreSQL 数据库(如 Supabase)
- LLM 提供商 API 密钥(如 OpenAI、OpenRouter 或 Ollama)
2. 安装方式
git clone https://github.com/coleam00/mcp-mem0.git
cd mcp-mem0
uv pip install -e .
3. 基础配置
创建 .env 文件并根据 .env.example 进行配置:
cp .env.example .env
然后编辑 .env 文件,设置以下变量:
TRANSPORT=sse
HOST=0.0.0.0
PORT=8050
LLM_PROVIDER=openai
LLM_BASE_URL=https://api.openai.com/v1
LLM_API_KEY=sk-...
LLM_CHOICE=gpt-4o-mini
EMBEDDING_MODEL_CHOICE=text-embedding-3-small
DATABASE_URL=postgresql://user:password@localhost:5432/mydb
4. 核心示例
from mcp_mem0 import save_memory, get_all_memories, search_memories
# 保存一条记忆
save_memory("用户询问了关于机器学习的问题")
# 获取所有记忆
memories = get_all_memories()
# 搜索相关记忆
results = search_memories("机器学习")
四、核心亮点
- 持久化记忆:支持 AI 代理长期存储和检索信息。
- 语义搜索:通过语义匹配快速找到相关记忆。
- 易于扩展:提供模板结构,便于自定义开发。
- 与 Mem0 集成:充分利用 Mem0 的强大功能。
- 多协议支持:支持 SSE 和 stdio,提高兼容性。
- Docker 支持:简化部署流程,提升可移植性。
五、适用场景
- AI 代理开发:为 AI 代理提供持久化记忆功能。
- 对话系统构建:记录用户交互历史,提升对话质量。
- 数据检索优化:通过语义搜索快速找到相关信息。
- 多模型集成:支持多种 LLM 提供商,灵活适配需求。
六、优缺点
优势
- 提供完整的 MCP 服务器模板,便于快速开发
- 与 Mem0 集成,增强 AI 代理能力
- 支持多种 LLM 提供商和数据库,灵活性高
不足
- 依赖外部服务(如 Supabase 或 PostgreSQL),部署复杂
- 对于新手可能需要一定学习成本
七、与同类工具对比(可选)
| 工具 |
类型 |
核心差异 |
| :--- |
:--- |
:--- |
| mcp-mem0 |
开源 |
免费开源;支持 Mem0 集成;提供完整模板 |
| 类似工具A |
商业 |
付费;功能受限;部署复杂 |
八、总结
mcp-mem0 是一款适合 AI 开发者和 MCP 服务器构建者的开源工具,其核心优势在于提供了持久化记忆功能、语义搜索能力和与 Mem0 的深度集成。它特别适用于需要为 AI 代理提供长期记忆能力的场景,但在部署时需要一定的技术基础。