使用说明
[!小心]
此项目已存档
mem0 mcp服务器 不再积极维护,此存储库现在是一个公共存档。
感谢640多名观星者、140多名分叉者以及帮助塑造这个项目的每一位贡献者。您的支持和反馈对我们来说意义重大。
您在寻找Mem0 MCP吗? 我们现在提供官方云托管MCP服务器。看看这个 文档 开始吧。
在所有主要客户端上快速安装:
npx mcp-add \ --name mem0-mcp \ --type http \ --url "https://mcp.mem0.ai/mcp" \ --clients "claude,claude code,cursor,windsurf,vscode,opencode"
Mem0 MCP服务器
mem0-mcp-server 包裹官员 Mem0 内存API作为模型上下文协议(MCP)服务器,因此任何兼容MCP的客户端(Claude Desktop、Cursor、自定义代理)都可以添加、搜索、更新和删除长期内存。
工具
服务器向LLM公开以下工具:
| 工具 | 说明 |
|---|---|
add_memory |
为用户/代理保存文本或对话历史记录(或显式消息对象)。 |
search_memories |
跨现有记忆的语义搜索(支持过滤器+限制)。 |
get_memories |
使用结构化过滤器和分页列出内存。 |
get_memory |
按以下方式检索一个内存 memory_id. |
update_memory |
用户确认后,覆盖内存的文本 memory_id. |
delete_memory |
通过以下方式删除单个内存 memory_id. |
delete_all_memories |
批量删除确认范围内的所有内存(user/agent/app/run)。 |
delete_entities |
删除用户/代理/app/run实体(及其内存)。 |
list_entities |
枚举存储在Mem0中的用户/代理/应用程序/运行。 |
所有响应都是从Mem0 API直接返回的JSON字符串。
使用选项
有三种方法可以使用Mem0 MCP服务器:
- Python 包 -使用在本地安装和运行
uvx使用任何MCP客户端 - 码头工人 -容器化部署,创建
/mcpHTTP端点 - 史密瑟里 -用于托管部署的远程托管服务
快速开始
安装
uv pip install mem0-mcp-server
或者使用pip:
pip install mem0-mcp-server
客户端配置
将此配置添加到MCP客户端:
{
"mcpServers": {
"mem0": {
"command": "uvx",
"args": ["mem0-mcp-server"],
"env": {
"MEM0_API_KEY": "m0-...",
"MEM0_DEFAULT_USER_ID": "your-handle"
}
}
}
}
使用Python代理进行测试
Click to expand: Test with the Python Agent
要立即测试服务器,请使用附带的Pydantic AI代理:
# Install the package
pip install mem0-mcp-server
# Or with uv
uv pip install mem0-mcp-server
# Set your API keys
export MEM0_API_KEY="m0-..."
export OPENAI_API_KEY="sk-openai-..."
# Clone and test with the agent
git clone https://github.com/mem0ai/mem0-mcp.git
cd mem0-mcp-server
python example/pydantic_ai_repl.py
使用不同的服务器配置:
# Use with Docker container
export MEM0_MCP_CONFIG_PATH=example/docker-config.json
export MEM0_MCP_CONFIG_SERVER=mem0-docker
python example/pydantic_ai_repl.py
# Use with Smithery remote server
export MEM0_MCP_CONFIG_PATH=example/config-smithery.json
export MEM0_MCP_CONFIG_SERVER=mem0-memory-mcp
python example/pydantic_ai_repl.py
你能做什么
Mem0 MCP服务器为您的AI应用程序提供强大的内存功能:
- 记住,我对花生和贝类过敏——给记忆添加新的健康信息
- 存储这些试验参数:200名参与者,双盲,安慰剂对照研究-保存研究数据
- 你对我的饮食偏好了解多少?-搜索和检索所有与食物相关的记忆
- 更新我的项目状态:移动应用程序现在已完成80%-用新信息修改现有内存
- 删除2023年的所有记忆,我需要一个新的开始-批量删除过时的记忆
- 显示我保存的关于Phoenix项目的所有内容-列出特定主题的所有记忆
配置
环境变量
MEM0_API_KEY(必需)–Mem0平台API密钥。MEM0_DEFAULT_USER_ID(可选)–默认值user_id注入过滤器和写入请求(默认为mem0-mcp).MEM0_ENABLE_GRAPH_DEFAULT(可选)–默认情况下启用图形存储器(默认为false).MEM0_MCP_AGENT_MODEL(可选)–捆绑代理示例的默认LLM(默认为openai:gpt-4o-mini).
高级设置
Click to expand: Docker, Smithery, and Development
Docker部署
使用Docker运行:
-
塑造形象:
docker build -t mem0-mcp-server . -
运行容器:
docker run --rm -d \ --name mem0-mcp \ -e MEM0_API_KEY=m0-... \ -p 8080:8081 \ mem0-mcp-server -
监控容器:
# View logs docker logs -f mem0-mcp # Check status docker ps
使用Smithery远程服务器运行
要连接到Smithery托管的服务器,请执行以下操作:
-
安装MCP服务器(Smithery依赖项现已捆绑):
pip install mem0-mcp-server -
使用Smithery配置MCP客户端:
{ "mcpServers": { "mem0-memory-mcp": { "command": "npx", "args": [ "-y", "@smithery/cli@latest", "run", "@mem0ai/mem0-memory-mcp", "--key", "your-smithery-key", "--profile", "your-profile-name" ], "env": { "MEM0_API_KEY": "m0-..." } } } }
开发设置
克隆并从源运行:
git clone https://github.com/mem0ai/mem0-mcp.git
cd mem0-mcp-server
pip install -e ".[dev]"
# Run locally
mem0-mcp-server
# Or with uv
uv sync
uv run mem0-mcp-server