mcp-memory-service

mcp-memory-service 是面向 AI 智能体管线的开源持久化共享记忆服务。其核心目标是解决 AI 助手在新会话中遗忘上下文的问题，自动捕获项目上下文、架构决策和代码模式，使新会话启动时即可获知已有信息。

用途 该服务为 AI 智能体提供自托管的持久化记忆后端，通过统一的 REST API、MCP、OAuth、CLI 和仪表盘支持多种传输方式，让智能体在不同会话和不同框架之间共享记忆，并支持因果知识图谱的检索。

主要能力

1. 框架无关的 REST API，无需 MCP 客户端库，端点列表位于 /api/docs。
2. 知识图谱，智能体可共享因果链而非仅共享事实。
3. X-Agent-ID 请求头，可按智能体身份自动标记记忆，实现作用域检索。
4. conversation_id，绕过去重以支持增量对话存储。
5. SSE 事件，当任意智能体存储或删除记忆时提供实时通知。
6. 嵌入向量通过 ONNX 在本地运行，记忆数据不会离开自有基础设施。
7. 持久化记忆支持跨会话上下文，并具备语义搜索。
8. 智能检索，使用 AI 嵌入自动查找相关上下文。
9. 约 5 毫秒速度，即时注入上下文，无延迟。
10. 可选 Cloudflare 后端的云端同步，用于团队协作。
11. 隐私优先，本地优先，用户掌控自己的数据。
12. Web 仪表盘，可在 http://localhost:8000 可视化和管理记忆，包含 Dashboard、Search、Browse、Documents、Manage、Analytics、Quality、API Docs 八个标签页。
13. 知识图谱，通过 D3.js 交互式可视化记忆关系。
14. Homelab 质量评分，可在任何兼容 OpenAI 的端点（Ollama、LiteLLM、vLLM）进行评分。
15. 实体提取，自动将 @mentions、#tags、URL 和文件路径链接到可查询的实体图谱。
16. 洞察卡片，整合过程将模式、趋势和知识缺口以结构化洞察呈现。
17. 标签匹配过滤，memory_search 支持 tag_match=AND/OR 以实现精确的多标签查询。

使用方式 可通过多种方式接入：

• 配置 AI 客户端：将服务加入配置文件，例如 macOS 的 ~/Library/Application Support/Claude/claude_desktop_config.json、Windows 的 %APPDATA%\Claude\claude_desktop_config.json、Linux 的 ~/.config/Claude/claude_desktop_config.json，然后重启 Claude Desktop，即可跨会话记忆；重启 Claude Code 后记忆工具会自动出现。
• REST API 操作：使用 POST /api/memories 存储记忆，POST /api/search 搜索，POST /api/search/by-tag 按标签检索。在存储请求中发送 X-Agent-ID: <id>，服务器会为该记忆标记 agent:<id>，之后通过标签搜索按此限定检索范围。
• OpenCode 插件：插件以仓库文件形式提供，需克隆仓库一次；安装步骤、/memory 斜杠命令和端点覆盖见 opencode/README.md。
• 远程 MCP：通过 HTTPS 上的 OAuth 2.0，支持自托管或云端托管，无需桌面应用即可在浏览器中使用；claude.ai 和 ChatGPT（开发者模式）可连接同一端点。Cloudflare Tunnel、Let's Encrypt、nginx、Caddy 和 Docker 生产环境配置参见 Remote MCP Setup 与 5 分钟教程。
• 后端选择：SQLite（本地、快速、单用户）、Cloudflare（云端、多设备同步）、Hybrid（本地读取约 5ms 加后台云同步，推荐用于生产）或 Milvus（专用向量数据库：Lite 文件、自托管或 Zilliz Cloud）。对于自托管团队部署，Hybrid 后端可通过 MCP_HYBRID_SECONDARY_BACKEND=http 同步到另一个 HTTP MCP Memory Service，而非 Cloudflare。长期运行的服务建议优先选择 Docker Milvus 或 Zilliz Cloud，而非 Milvus Lite。

适用场景

• 智能体框架（REST）：LangGraph、CrewAI、AutoGen、OpenClaw/Nanobot 以及任意 HTTP 客户端。
• CLI 与终端（MCP）：Claude Code、Gemini CLI、OpenCode、Codex CLI、Goose、Aider、Amp。
• 桌面与 IDE（MCP）：Claude Desktop、VS Code、Cursor、Windsurf、Raycast、JetBrains、Zed。
• 聊天（MCP）：ChatGPT（开发者模式）、claude.ai（通过 HTTPS 的远程 MCP）。
• 完整列表以及不支持 OAuth 的客户端（如 Home Assistant）参见 docs/integrations.md。

限制与注意事项

• 安全提示：服务器默认绑定到 127.0.0.1（仅本地）。使用 --host 0.0.0.0 或 MCP_HTTP_HOST=0.0.0.0 会将 API 暴露到网络，仅应在受信任环境中配合身份验证和防火墙规则，或置于 TLS 终止或 VPN 覆盖层之后。
• 部分配置命令针对快速启动优化，避免加载重型 ML 依赖，除非需要。
• 长期运行的服务不建议使用 Milvus Lite，应优先选择 Docker Milvus 或 Zilliz Cloud。
• 该服务由单人维护，可通过 Ko-fi、Buy Me a Coffee 或 PayPal 支持其开发。
• 详细文档涵盖以下方面：Setup Guide、Agent Integration Guides、Remote MCP Setup、Configuration Guide、Architecture Overview、Knowledge Graph Dashboard、Benchmarks（LongMemEval、DevBench、LoCoMo）、Migration Guide、Troubleshooting、Wiki 等。