MindCore Memory MCP

面向生产环境强化的 MCP 记忆服务 — 为 AI Agent 提供混合搜索与弹性能力

唯一具备断路器、SLO 跟踪和 BM25+FAISS 混合搜索的 MCP 记忆服务。 AI Agent 会忘记会话之间的一切。MindCore Memory 为它们提供持久、可搜索、达到生产级别的记忆——118/118 项测试全部通过，并配备完整的 CI/CD。

⭐ 如果这个项目能帮助你的 AI 记住信息，给我们点个星标就是对我们最大的支持。

快速开始

# 1. Install
pip install mindcore-memory

# 2. Launch (stdio mode — works with any MCP client)
mindcore-memory

# 3. Your AI agent remembers across sessions

{
  "mcpServers": {
    "mindcore-memory": {
      "command": "python",
      "args": ["-m", "mindcore_memory.server"],
      "env": { "MINDCORE_MEMORY_PATH": "~/.mindcore/memory" }
    }
  }
}

pip install mindcore-memory[semantic]
# Enables FAISS embeddings for hybrid BM25+semantic search

为什么选择 MindCore——与竞品对比

**MindCore 是唯一从第一天起就面向生产工作负载设计的 MCP 记忆服务。**断路器可防止嵌入服务故障造成影响。指数退避重试可处理瞬时错误。SLO 跟踪能在用户察觉之前发出警报。支持向你的监控技术栈导出指标。其他所有服务都假设一切正常——MindCore 不会。

独特功能：3D 边界平衡算法

MindCore 不只是记忆存储——它还是一个认知边界引擎。每条存储的记忆都会自动通过一个基于**正反公式（Forward/Reverse Formula）**的四维评分系统进行评估：

BND_score = 0.28·TRJ(Trajectory) + 0.28·EVO(Evolution) + 0.28·COG(Cognition) + 0.16·BALANCE

• 正向循环：TRJ → BND → EVO → COG → BND（每一步都会划定边界，每个边界都是成长）
• 反向链条：混乱 → 未知 → 风险 → 伤害 → 死亡（2 个或以上触发因素关联时，自动扣减 50% 分数）
• 3D 平衡：TRJ/EVO/COG 之间的方差会惩罚失衡的记忆（缺乏洞见的纯数据堆砌）
• 无需调用 LLM：纯算法评估，使用关键词模式、正则表达式和统计方差

from mindcore_memory import BNDManager
bnd = BNDManager()
result = bnd.evaluate("基于之前修复, 理解到根因, 改进后提升30%", importance=4)
# → TRJ:0.63  EVO:0.54  COG:0.61  BALANCE:0.98  BND:0.75  ACCEPTED

📖 算法文档全文

**其他 MCP 记忆服务都没有这项功能。**BND 将记忆存储从被动的数据堆砌转变为主动的认知筛选器——过滤噪声、标记风险链条，并确保只有结构化且面向成长的知识进入版本链。

生产级功能

弹性层

• 熔断器：CLOSED → OPEN → HALF_OPEN 状态机。保护 FAISS/嵌入操作，避免故障级联。
• 重试：采用带抖动的指数退避。瞬时错误会自动重试，永久性错误则快速失败。
• 输入验证：在服务端进行清理，防范注入攻击。

可观测性层

• SLO 跟踪：为全部 6 项操作设定 P95/P99 延迟目标。违规情况会记录并导出。
• Prometheus /metrics：零依赖、兼容 Prometheus 的采集器。可直接接入任何监控堆栈。

数据层

• 加密：可选的静态 Fernet 加密（mindcore-memory[encrypt]）。
• 去重：精确匹配合并——相同的记忆会更新重要性/置信度，而不是重复存储。
• 智能淘汰：清理重要性较低的记忆，并以原子方式同步到磁盘。不会产生僵尸记忆。

核心工具

记忆（6 个工具）

边界与推理（3 个工具）🆕

搜索公式：score = BM25(40%) + FAISS(50%) + importance(5%) + recency(5%)

FAISS 嵌入不可用时，会自动回退到仅使用 BM25 的关键词搜索。

架构

┌───────────────────┐     MCP JSON-RPC      ┌────────────────────────────┐
│  AI Client         │ ◄──────────────────► │  MindCore Memory           │
│  (Claude/Cursor)   │     stdio / HTTP     │  MCP Server                │
└───────────────────┘                       └──────────┬─────────────────┘
                                                       │
                                            ┌──────────▼─────────────────┐
                                            │  Memory Engine             │
                                            │  ┌──────────────────────┐  │
                                            │  │ Hybrid Search        │  │
                                            │  │  BM25 (keyword) 40%  │  │
                                            │  │  FAISS (semantic)50%│  │
                                            │  │  importance        5%│  │
                                            │  │  recency           5%│  │
                                            │  └──────────────────────┘  │
                                            │  ┌──────────────────────┐  │
                                            │  │ Resilience           │  │
                                            │  │  Circuit Breaker     │  │
                                            │  │  Retry + Backoff     │  │
                                            │  │  SLO Tracking        │  │
                                            │  └──────────────────────┘  │
                                            └──────────┬─────────────────┘
                                                       │
                                            ┌──────────▼─────────────────┐
                                            │  Storage                   │
                                            │  JSONL (append)            │
                                            │  + FAISS index (IVF > 500) │
                                            │  + Fernet encrypt (opt)    │
                                            └────────────────────────────┘

• 嵌入式：无需 PostgreSQL、Redis 或外部服务。一个二进制文件，本地 JSONL + FAISS。
• IVF 索引：当记忆达到 500 条以上时，FAISS 倒排文件索引会启用，实现 O(√N) 搜索。
• MCP 原生：通过 stdio 和 HTTP 传输提供完整的 MCP 协议支持。

可用平台

完整对比

请参阅 docs/comparison.md，了解涵盖架构、搜索质量、延迟和迁移指南的 5 个服务详细对比。

参与贡献

完整指南请参阅 CONTRIBUTING.md。快速开始：

git clone https://github.com/woshilaohei/mindcore-memory-mcp.git
cd mindcore-memory-mcp
pip install -e ".[dev]"
pytest -v              # 118 tests
ruff check .           # linter
mypy mindcore_memory/  # type checker

许可证

MIT 许可证 — 版权所有 (c) 2025 Lao Hei