Mem0 MCP Server 9b3ac333

MCPAI代理

提供方 Mocha-s

AI代理 stdio · 本地进程 Token 官方维护 Claude DesktopClaude
查看接入方式

Mem0 MCP Server是一个基于TypeScript和官方MCP SDK的企业级智能内存管理服务器,提供完整的内存管理工具集和高效的用户上下文管理。

一句话选型结论

按资料字段整理

Mem0 MCP Server 9b3ac333 属于AI代理类 MCP 服务器,stdio · 本地进程,Token,可直接接入 Claude Desktop、Claude,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类AI代理 传输方式stdio · 本地进程 鉴权Token 部署方式本地部署
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 6 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 官方维护 核验等级 仅资料核对

工具与能力

AI代理
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量6暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

内存管理TypeScript本地部署企业级服务MCP协议用户上下文

安装与配置

stdio · 本地进程 Token
客户端在本机拉起子进程,数据不出本机
docker run -d \

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Docker,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 6 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
给代理接外部能力

让代理在任务中途调用搜索、数据库等真实工具。

多步任务编排

把一串操作拆成步骤,由代理按顺序执行。

自动化重复流程

把固定流程交给代理跑,减少手工操作。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 6 个工具,职责相对集中,接入后不容易误操作。
  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude Desktop、Claude,换客户端不用重新研究配置。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 使用前要准备好Token对应的凭据,并按最小权限配置。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在AI代理场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Mem0 MCP Server 9b3ac333当前 6 stdio · 本地进程 本地部署 有 2026-05-17
Filesystem 560c4363 13 未标注 本地部署 无 2026-05-17
Server Everything (everything) 11 stdio · 本地进程 本地部署 有 2026-05-17
Time 7365cb6d 2 SSE · 服务端推送 远程部署 有 2026-05-18
Everything Claude Code 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Openmemory 557e1585 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

AI代理
字段来自项目仓库与公开索引,中文说明由本站标注
提供方Mocha-s上游标注的维护方 Mocha-s
分类AI代理本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式Token远程服务建议用最小权限凭据
维护方官方维护核验等级 仅资料核对
包名 / 运行时未标注 · Docker本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

12.3 KB
来自项目仓库与上游目录的原文,未做删改

Mem0 MCP Server v2.0

🧠 智能内存管理MCP服务器 - 基于TypeScript和官方MCP SDK的企业级实现

🎯 最新优化 (v2.0.1)

基于官方 MCP SDK 的全面重构优化 - 2025年8月

核心改进

  • ✅ 用户上下文自动注入: 支持 /mcp/{user_id} 路径格式,无需手动传递用户ID
  • ✅ AsyncLocalStorage 集成: 实现线程安全的用户上下文管理
  • ✅ 官方SDK标准化: 完全基于 @modelcontextprotocol/sdk 重构
  • ✅ 会话管理优化: 改进 StreamableHTTPTransport 初始化和复用
  • ✅ SOLID原则实践: 单一职责、开放封闭、依赖倒置等原则全面应用

技术亮点```bash

用户上下文自动提取

POST /mcp/alice # 自动使用 user_id="alice"
POST /mcp/bob # 自动使用 user_id="bob"

工具调用无需显式传递user_id

🎯 Auto-injecting user_id: alice from AsyncLocalStorage context


### 架构升级
- 🔧 **TypeScript类型安全**: 添加完整类型支持
- 🚀 **性能优化**: 减少内存占用,提升并发处理
- 🛡️ **安全增强**: 用户ID格式验证,会话隔离
- 📈 **可维护性**: 代码复杂度降低40%

## 📋 目录

- 功能特性
- 系统架构
- 快速开始
- 工具说明
- API参考
- 部署指南
- 开发指南
- 故障排除

## 🎯 功能特性

### 核心能力
- ✅ **完整MCP实现** - 严格遵循MCP 2025-06-18规范
- ✅ **TypeScript原生** - 100%类型安全,智能代码提示
- ✅ **6大内存工具** - 覆盖内存管理全生命周期
- ✅ **多策略支持** - 语义、图形、混合等多种执行策略
- ✅ **企业级设计** - 生产就绪,高可用架构

### 技术特点
- 🚀 **高性能** - 异步非阻塞,支持并发请求
- 🔒 **安全可靠** - JWT会话管理,CORS保护
- 🌐 **灵活部署** - 支持stdio/HTTP双模式
- 📊 **可观测性** - 健康检查,实时日志
- 🔧 **易于扩展** - 模块化设计,插件友好

## 🏗️ 系统架构```
┌─────────────────────────────────────────────┐
│           MCP Client (Claude等)             │
└─────────────┬───────────────────────────────┘
              │ HTTP/stdio
┌─────────────▼───────────────────────────────┐
│         MCP Server (TypeScript)             │
│  ┌──────────────────────────────────────┐  │
│  │     Express HTTP Transport Layer     │  │
│  └──────────────┬───────────────────────┘  │
│  ┌──────────────▼───────────────────────┐  │
│  │        McpServer Core (SDK)          │  │
│  └──────────────┬───────────────────────┘  │
│  ┌──────────────▼───────────────────────┐  │
│  │         Memory Tools Layer           │  │
│  └──────────────┬───────────────────────┘  │
└─────────────────┼───────────────────────────┘
                  │ REST API
┌─────────────────▼───────────────────────────┐
│          Mem0 API Server                    │
│         (localhost:8000)                    │
└─────────────────────────────────────────────┘

🚀 快速开始

前置要求

  • Node.js >= 18.0.0
  • npm >= 9.0.0
  • Mem0 API服务器 (本地或远程)

安装步骤

  1. 克隆项目```bash
    git clone <repository-url>
    cd mem0_mcp_server

2. **安装依赖**```bash
npm install
  1. 环境配置```bash

创建环境配置文件

cp .env.example .env

编辑配置

nano .env


环境变量说明:```env
# Mem0 API配置 (必需)
MEM0_API_URL=http://localhost:8000  # Mem0 API服务器地址
MEM0_API_KEY=your_api_key          # API密钥(如需要)

# MCP服务器配置 (可选)
MCP_HOST=127.0.0.1                 # 监听地址
MCP_PORT=8081                      # 监听端口
MCP_SESSION_TIMEOUT=3600           # 会话超时(秒)
MCP_CORS_ORIGINS=*                 # CORS允许的源
MCP_DEV_MODE=false                 # 开发模式

# Mem0配置 (可选)
MEM0_ORG_ID=your_org_id           # 组织ID
MEM0_PROJECT_ID=your_project_id   # 项目ID
MEM0_TIMEOUT=30000                 # 请求超时(毫秒)
MEM0_MAX_RETRIES=3                 # 最大重试次数
  1. 构建项目```bash
    npm run build

5. **启动服务器**

**HTTP模式 (推荐)**```bash
# 本地访问
npm run start:http

# 局域网访问
npm run start:http:external

stdio模式```bash
npm start


### 验证安装```bash
# 健康检查
curl http://localhost:8081/health

# 预期输出
{
  &quot;status&quot;: &quot;healthy&quot;,
  &quot;server&quot;: &quot;mem0-mcp-server&quot;,
  &quot;version&quot;: &quot;2.0.0&quot;,
  &quot;timestamp&quot;: &quot;2025-08-23T05:00:00.000Z&quot;,
  &quot;activeSessions&quot;: 0,
  &quot;mem0Api&quot;: {
    &quot;url&quot;: &quot;http://localhost:8000&quot;,
    &quot;connected&quot;: true
  }
}

🛠️ 工具说明

1. mem0_add_memory

功能: 从对话中提取并添加新内存

参数:
- messages (required): 对话消息数组
- user_id (required): 用户标识符
- enable_graph (optional): 启用图形关系
- metadata (optional): 附加元数据
- infer (optional): 自动推理事实

示例:```json
{
"messages": [
{"role": "user", "content": "我下个月要去东京旅行"},
{"role": "assistant", "content": "好的,我记住了"}
],
"user_id": "alice",
"enable_graph": true,
"metadata": {"category": "travel"}
}


### 2. mem0_search_memories
**功能**: 智能搜索内存库

**参数**:
- `query` (required): 搜索查询
- `user_id` (required): 用户ID
- `strategy` (optional): 搜索策略 [semantic · graph · advanced_retrieval · hybrid]
- `top_k` (optional): 返回数量
- `threshold` (optional): 相似度阈值

**策略说明**:
- `semantic`: 基于语义向量的相似度搜索
- `graph`: 利用知识图谱关系搜索
- `advanced_retrieval`: 高级检索与重排序
- `hybrid`: 混合多种策略的智能搜索

### 3. mem0_update_memory
**功能**: 更新现有内存

**模式**:
- 单个更新: 指定memory_id
- 批量更新: 使用batch_updates数组

### 4. mem0_delete_memory
**功能**: 删除内存记录

**模式**:
- 按ID删除: 指定memory_id
- 按用户删除: 指定user_id
- 条件删除: 使用filters
- 批量删除: 使用batch_deletes

### 5. mem0_selective_memory
**功能**: 基于条件的聚合操作

**操作类型**:
- `add`: 添加符合条件的内存
- `search`: 搜索符合条件的内存
- `update`: 更新符合条件的内存
- `delete`: 删除符合条件的内存

### 6. mem0_criteria_retrieval
**功能**: 高级条件检索

**特性**:
- 支持复杂的AND/OR条件组合
- 多维度评分机制
- 智能结果排序

## 📡 API参考

### HTTP端点

| 端点 | 方法 | 描述 |
|------|------|------|
| `/mcp` | POST | MCP请求处理 (需手动传递user_id) |
| `/mcp/{user_id}` | POST | MCP请求处理 (自动注入用户上下文) |
| `/mcp` | GET | SSE事件流 |
| `/mcp/{user_id}` | GET | SSE事件流 (用户上下文) |
| `/mcp` | DELETE | 会话终止 |
| `/mcp/{user_id}` | DELETE | 会话终止 (用户上下文) |
| `/health` | GET | 健康检查 |

### 用户上下文自动注入

**新特性**: 通过路径自动提取用户身份,简化工具调用```bash
# 传统方式 - 需要在每个工具调用中传递user_id
POST /mcp
{
  &quot;method&quot;: &quot;tools/call&quot;,
  &quot;params&quot;: {
    &quot;name&quot;: &quot;mem0_search_memories&quot;,
    &quot;arguments&quot;: {
      &quot;query&quot;: &quot;我的旅行计划&quot;,
      &quot;user_id&quot;: &quot;alice&quot;  # 必须手动传递
    }
  }
}

# 优化方式 - 自动从路径提取user_id
POST /mcp/alice
{
  &quot;method&quot;: &quot;tools/call&quot;,
  &quot;params&quot;: {
    &quot;name&quot;: &quot;mem0_search_memories&quot;,
    &quot;arguments&quot;: {
      &quot;query&quot;: &quot;我的旅行计划&quot;
      # user_id 自动注入为 &quot;alice&quot;
    }
  }
}

MCP协议方法

方法 描述
initialize 初始化会话
tools/list 列出可用工具
tools/call 调用工具

🚢 部署指南

Docker部署

  1. 构建镜像```bash
    docker build -t mem0-mcp-server .

2. **运行容器**```bash
docker run -d \
  --name mem0-mcp \
  -p 8081:8081 \
  -e MEM0_API_URL=http://host.docker.internal:8000 \
  -e MEM0_API_KEY=your_key \
  mem0-mcp-server

PM2部署```bash

安装PM2

npm install -g pm2

启动服务

pm2 start npm --name "mem0-mcp" -- run start:http:external

保存配置

pm2 save
pm2 startup


### systemd服务```ini
[Unit]
Description=Mem0 MCP Server
After=network.target

[Service]
Type=simple
User=www-data
WorkingDirectory=/opt/mem0_mcp_server
ExecStart=/usr/bin/node dist/index.js --http --host 0.0.0.0 --port 8081
Restart=on-failure
Environment=MEM0_API_URL=http://localhost:8000

[Install]
WantedBy=multi-user.target

💻 开发指南

项目结构```

mem0_mcp_server/
├── src/
│ ├── index.ts # 主入口
│ ├── config/
│ │ └── index.ts # 配置管理
│ ├── client/
│ │ └── mem0-api.ts # Mem0 API客户端
│ └── tools/
│ └── index.ts # 工具实现
├── dist/ # 编译输出
├── package.json # 项目配置
├── tsconfig.json # TypeScript配置
└── README.md # 本文档


### 开发命令```bash
# 开发模式(自动重载)
npm run dev

# 构建项目
npm run build

# 运行测试
npm test

# 代码检查
npm run lint

# 格式化代码
npm run format

添加新工具

  1. 在 src/tools/index.ts 中添加工具方法
  2. 在 src/index.ts 中注册工具
  3. 更新本README的工具说明

🔧 MCP客户端配置

Claude Desktop

编辑 claude_desktop_config.json:```json
{
"mcpServers": {
"mem0": {
"transport": "http",
"endpoint": "http://localhost:8081/mcp",
"env": {
"MEM0_API_KEY": "your_api_key"
}
}
}
}


### 其他MCP客户端```json
{
  &quot;servers&quot;: [
    {
      &quot;name&quot;: &quot;mem0&quot;,
      &quot;type&quot;: &quot;http&quot;,
      &quot;url&quot;: &quot;http://localhost:8081/mcp&quot;,
      &quot;headers&quot;: {
        &quot;Authorization&quot;: &quot;Token your_api_key&quot;
      }
    }
  ]
}

❓ 故障排除

常见问题

Q: 无法连接到Mem0 API```bash

检查Mem0服务状态

curl http://localhost:8000/health

验证API密钥

curl -H "Authorization: Token YOUR_KEY" http://localhost:8000/v1/memories/


**Q: 会话ID无效**
- 确保客户端正确处理mcp-session-id header
- 检查会话超时设置

**Q: CORS错误**
- 设置 `MCP_CORS_ORIGINS=*` 允许所有源
- 或指定具体的允许源

**Q: 端口已占用**```bash
# 查找占用端口的进程
lsof -i :8081

# 或使用其他端口
npm run start:http -- --port 8082

日志调试```bash

启用调试日志

MCP_DEV_MODE=true npm run start:http

查看实时日志

tail -f logs/mcp-server.log
```

📈 性能优化

  • 连接池: Mem0客户端使用持久连接
  • 重试机制: 指数退避算法
  • 超时控制: 可配置的请求超时
  • 并发限制: 防止资源耗尽

🔒 安全建议

  1. 生产环境:
    - 使用HTTPS
    - 启用认证
    - 限制CORS源
    - 配置防火墙

  2. API密钥:
    - 使用环境变量
    - 定期轮换
    - 限制权限范围

  3. 网络:
    - 使用私有网络
    - 配置VPN访问
    - 监控异常流量

🤝 贡献指南

欢迎贡献代码、报告问题或提出建议!

  1. Fork项目
  2. 创建特性分支
  3. 提交变更
  4. 推送到分支
  5. 创建Pull Request

📄 许可证

MIT License - 详见 LICENSE 文件

🔗 相关链接

  • MCP规范
  • Mem0文档
  • TypeScript手册
  • 问题反馈

💡 提示: 遇到问题?查看故障排除或提交Issue

⭐ 如果这个项目对你有帮助,请给我们一个Star!

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
Mem0 MCP Server 9b3ac333 怎么安装?

在客户端按下面的安装命令接入:docker run -d \。装完在客户端配置里引用同一个包或端点。

Mem0 MCP Server 9b3ac333 怎么在 Claude Desktop、Claude 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Mem0 MCP Server 9b3ac333 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Mem0 MCP Server 9b3ac333 需要 API Key 吗?

资料标注需要Token认证,使用前准备好对应凭据,并按最小权限配置。

Mem0 MCP Server 9b3ac333 支持哪些客户端?

资料标注支持 Claude Desktop、Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Mem0 MCP Server 9b3ac333 能提供哪些能力?

资料显示约 6 个工具;能力标签包括 内存管理、TypeScript、Claude。具体工具清单以官方文档为准。

Mem0 MCP Server 9b3ac333 需要什么运行环境?

运行时为 Docker;属于本地进程,需要在本机装好运行环境。

Mem0 MCP Server 9b3ac333 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。