mcp-memory-service

AI Agent 流水线的持久化共享内存

用于多 Agent 系统的开源内存后端。 Agent 可以存储决策、共享因果知识图谱，并能在 5 毫秒内检索上下文 —— 无需厂商锁定，也无 API 调用成本。

支持 LangGraph · CrewAI · AutoGen · 任何 HTTP 客户端 · Claude Desktop

---

---

🌐 支持 claude.ai（浏览器版）

不同于仅支持桌面端的 MCP 服务器，mcp-memory-service 支持 Remote MCP，可与 claude.ai 进行原生集成。

这意味着：

• ✅ 直接在浏览器中使用持久化内存（无需 Claude Desktop）
• ✅ 适用于任何设备（笔记本、平板、手机）
• ✅ 企业级就绪（OAuth 2.0 + HTTPS + CORS）
• ✅ 可自托管或云端托管（由您决定）

5 分钟快速配置：

# 1. 启动开启 Remote MCP 的服务器
MCP_STREAMABLE_HTTP_MODE=1 \
MCP_SSE_HOST=0.0.0.0 \
MCP_SSE_PORT=8765 \
MCP_OAUTH_ENABLED=true \
python -m mcp_memory_service.server

# 2. 通过 Cloudflare Tunnel（或您自己的 HTTPS 设置）暴露服务
cloudflared tunnel --url http://localhost:8765
# → 输出: https://random-name.trycloudflare.com

# 3. 在 claude.ai 中: 设置 (Settings) → 连接器 (Connectors) → 添加连接器
# 粘贴 URL: https://random-name.trycloudflare.com/mcp
# OAuth 流程将自动处理身份验证

生产环境配置： 请查看 Remote MCP 配置指南以了解关于 Let's Encrypt、nginx 和防火墙的配置。 分步教程： 博客：5 分钟配置 claude.ai | Wiki 指南

---

为什么 Agent 需要它

无 mcp-memory-service	使用 mcp-memory-service
每个 Agent 运行都从零开始	Agent 在 5 毫秒内检索先前的决策
内存仅限于单个图/运行	内存可在所有 Agent 和运行之间共享
需要管理 Redis + Pinecone + 胶水代码	一个自托管服务，零云端成本
事实之间无因果关联	带有类型化边（因果、修复、矛盾）的知识图谱
上下文窗口限制导致遗忘	自动合并机制压缩旧记忆

适用于 Agent 流水线的核心功能：

• 框架无关的 REST API — 15 个端点，无需 MCP 客户端库
• 知识图谱 — Agent 不仅共享事实，还共享因果链
• X-Agent-ID 标头 — 按 Agent 身份自动标记内存，实现范围化检索
• conversation_id — 跳过去重，支持增量对话存储
• SSE 事件 — 当任何 Agent 存储或删除内存时，提供实时通知
• 通过 ONNX 本地运行 Embedding — 内存绝不会离开您的基础设施

Agent 快速上手

pip install mcp-memory-service
MCP_ALLOW_ANONYMOUS_ACCESS=true memory server --http
# REST API 运行在 http://localhost:8000

import httpx

BASE_URL = "http://localhost:8000"

# 存储 — 使用 X-Agent-ID 标头自动标记
async with httpx.AsyncClient() as client:
    await client.post(f"{BASE_URL}/api/memories", json={
        "content": "API rate limit is 100 req/min",
        "tags": ["api", "limits"],
    }, headers={"X-Agent-ID": "researcher"})
    # 存储并带有标签: ["api", "limits", "agent:researcher"]

# 搜索 — 限制在特定 Agent 范围内
    results = await client.post(f"{BASE_URL}/api/memories/search", json={
        "query": "API rate limits",
    })