mem0_mcp_server

Mocha-s/mem0_mcp_server

3.2

If you are the rightful owner of mem0_mcp_server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

The Mem0 MCP Server is a service-oriented hybrid architecture designed to implement the MCP 2025-06-18 specification, supporting Streamable HTTP transmission.

Tools
5
Resources
0
Prompts
0

Mem0 MCP Server v2.0

🧠 智胜内存管理MCP服务噚 - 基于TypeScript和官方MCP SDK的䌁䞚级实现

MCP TypeScript SDK Node

🎯 最新䌘化 (v2.0.1)

基于官方 MCP SDK 的党面重构䌘化 - 2025幎8月

栞心改进

  • ✅ 甚户䞊䞋文自劚泚入: 支持 /mcp/{user_id} 路埄栌匏无需手劚䌠递甚户ID
  • ✅ AsyncLocalStorage 集成: 实现线皋安党的甚户䞊䞋文管理
  • ✅ 官方SDK标准化: 完党基于 @modelcontextprotocol/sdk 重构
  • ✅ 䌚话管理䌘化: 改进 StreamableHTTPTransport 初始化和倍甚
  • ✅ SOLID原则实践: 单䞀职莣、匀攟封闭、䟝赖倒眮等原则党面应甚

技术亮点

# 甚户䞊䞋文自劚提取
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%

📋 目圕

🎯 功胜特性

栞心胜力

  • ✅ 完敎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. 克隆项目
git clone <repository-url>
cd mem0_mcp_server
  1. 安装䟝赖
npm install
  1. 环境配眮
# 创建环境配眮文件
cp .env.example .env

# 猖蟑配眮
nano .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. 构建项目
npm run build
  1. 启劚服务噚

HTTP暡匏 (掚荐)

# 本地访问
npm run start:http

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

stdio暡匏

npm start

验证安装

# 健康检查
curl http://localhost:8081/health

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

🛠 工具诎明

1. mem0_add_memory

功胜: 从对话䞭提取并添加新内存

参数:

  • messages (required): 对话消息数组
  • user_id (required): 甚户标识笊
  • enable_graph (optional): 启甚囟圢关系
  • metadata (optional): 附加元数据
  • infer (optional): 自劚掚理事实

瀺䟋:

{
  "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端点

端点方法描述
/mcpPOSTMCP请求倄理 (需手劚䌠递user_id)
/mcp/{user_id}POSTMCP请求倄理 (自劚泚入甚户䞊䞋文)
/mcpGETSSE事件流
/mcp/{user_id}GETSSE事件流 (甚户䞊䞋文)
/mcpDELETE䌚话终止
/mcp/{user_id}DELETE䌚话终止 (甚户䞊䞋文)
/healthGET健康检查

甚户䞊䞋文自劚泚入

新特性: 通过路埄自劚提取甚户身仜简化工具调甚

# 䌠统方匏 - 需芁圚每䞪工具调甚䞭䌠递user_id
POST /mcp
{
  "method": "tools/call",
  "params": {
    "name": "mem0_search_memories",
    "arguments": {
      "query": "我的旅行计划",
      "user_id": "alice"  # 必须手劚䌠递
    }
  }
}

# 䌘化方匏 - 自劚从路埄提取user_id
POST /mcp/alice
{
  "method": "tools/call", 
  "params": {
    "name": "mem0_search_memories",
    "arguments": {
      "query": "我的旅行计划"
      # user_id 自劚泚入䞺 "alice"
    }
  }
}

MCP协议方法

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

🚢 郚眲指南

Docker郚眲

  1. 构建镜像
docker build -t mem0-mcp-server .
  1. 运行容噚
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郚眲

# 安装PM2
npm install -g pm2

# 启劚服务
pm2 start npm --name "mem0-mcp" -- run start:http:external

# 保存配眮
pm2 save
pm2 startup

systemd服务

[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            # 本文档

匀发呜什

# 匀发暡匏(自劚重蜜)
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:

{
  "mcpServers": {
    "mem0": {
      "transport": "http",
      "endpoint": "http://localhost:8081/mcp",
      "env": {
        "MEM0_API_KEY": "your_api_key"
      }
    }
  }
}

其他MCP客户端

{
  "servers": [
    {
      "name": "mem0",
      "type": "http",
      "url": "http://localhost:8081/mcp",
      "headers": {
        "Authorization": "Token your_api_key"
      }
    }
  ]
}

❓ 故障排陀

垞见问题

Q: 无法连接到Mem0 API

# 检查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: 端口已占甚

# 查扟占甚端口的进皋
lsof -i :8081

# 或䜿甚其他端口
npm run start:http -- --port 8082

日志调试

# 启甚调试日志
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 - 诊见 文件

🔗 盞关铟接

💡 提瀺: 遇到问题查看故障排陀或提亀Issue

⭐ 劂果这䞪项目对䜠有垮助请给我们䞀䞪Star