星战科技xingzhan.cloud
返回市场
内存服务

内存服务

作者：doobidoo872 星标更新：2025-11-24
安装使用来源：spider==github.com

项目介绍

MCP 内存服务

许可证：Apache 2.0 PyPI 版本 Python CI/CD 下载量 最近一次提交 GitHub Stars 生产就绪

与 Claude 兼容 与 Cursor 兼容 MCP 协议兼容 多客户端 Docker 可用 问题 询问 DeepWiki

生产就绪的 MCP 内存服务，具有零数据库锁定、混合后端（快速本地存储 + 云同步）以及针对AI 助手的智能内存搜索。特性包括v8.9.0 自动配置以支持多客户端访问、5毫秒本地读取并进行后台 Cloudflare 同步、自然记忆触发器准确率超过85%，以及OAuth 2.1 团队协作。适用于Claude Desktop、VS Code、Cursor、Continue 和13+ AI 应用程序。

<img width="240" alt="MCP 内存服务" src="https://gips3.baidu.com/it/u=3424580870,2305207473&fm=3081&app=3081&f=PNG?w=480&h=576" />

🚀 快速开始（2分钟）

🆕 最新版本：v8.37.0（2025年11月24日）

代码质量里程碑 - 重复合并完成

  • ✨ 阶段2a 完成 - 消除了5个高复杂度函数的重复（问题#246）
  • 🎯 检测GPU()合并 - 3种实现 → 1种规范（配置驱动）
  • 🔧 验证安装()合并 - 2种实现 → 1种规范（健壮检查）
  • 📊 影响 - 高复杂度函数：27 → 24（减少11%），提高了可维护性
  • 🏆 质量改进 - 配置驱动模式取代了单体式的if/elif链

之前的版本：

  • v8.36.1 - 关键热修复：HTTP服务器启动崩溃修复（在analytics.py中向前引用错误）
  • v8.36.0 - 代码质量：阶段2完成（目标达成100%，减少了39个复杂度点）
  • v8.35.0 - 代码质量：阶段2批次1（install.py, cloudflare.py，减少了15个复杂度点）
  • v8.34.0 - 代码质量：阶段2复杂度降低（重构了analytics.py，复杂度从11降至6-7）
  • v8.33.0 - 关键安装错误修复 + 代码质量改进（清理死代码，自动MCP设置）
  • v8.32.0 - 代码质量卓越：集成pyscn静态分析（多层次QA工作流）
  • v8.31.0 - 革命性的批量更新性能（内存整合速度提升21,428倍）
  • v8.30.0 - 分析智能：自适应图表及关键数据修正（精确趋势可视化）
  • v8.28.1 - 关键HTTP MCP传输JSON-RPC 2.0合规性修复（Claude Code兼容性）
  • v8.28.0 - Cloudflare AND/OR标签过滤（统一搜索API，3-5倍更快的混合同步）
  • v8.27.1 - 关键热修复：时间戳回归（metadata同步时保留created_at）
  • v8.26.0 - 革命性的MCP性能（工具速度提升534,628倍，缓存命中率超过90%）
  • v8.25.0 - 混合后端漂移检测（自动metadata同步，双向感知）
  • v8.24.4 - 从Gemini代码辅助获得的代码质量改进（正则表达式净化，DOM缓存）
  • v8.24.3 - 测试覆盖率及发布代理改进（带时间和标签过滤的测试，版本历史修正）
  • v8.24.2 - CI/CD工作流程修复（bash errexit处理，捕获退出码）
  • v8.24.1 - 测试基础设施改进（解决了27个测试失败，通过率从63%提高到71%）
  • v8.24.0 - 启用了PyPI发布（通过GitHub Actions自动发布包）
  • v8.23.1 - 防止过期虚拟环境系统（六层开发者保护）
  • v8.23.0 - 通过代码执行API的合并调度器（减少了88%的令牌）

📖 详细信息：CHANGELOG.md | 所有版本

# 一键安装并自动配置
git clone https://github.com/doobidoo/mcp-memory-service.git
cd mcp-memory-service && python install.py

# 当提示时选择选项4（混合 - 推荐）
# 安装程序会自动配置：
#   ✅ 并发访问的SQLite pragma
#   ✅ 用于云同步的Cloudflare凭证
#   ✅ Claude Desktop集成

# 完成！快速本地 + 云同步，无数据库锁定

PyPI 安装（最简单）

从PyPI安装：

# 从PyPI安装最新版本
pip install mcp-memory-service

# 或使用uv（更快）
uv pip install mcp-memory-service

然后配置Claude Desktop，通过添加到~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或等效文件中：

{
  "mcpServers": {
    "memory": {
      "command": "memory",
      "args": ["server"],
      "env": {
        "MCP_MEMORY_STORAGE_BACKEND": "hybrid"
      }
    }
  }
}

对于高级配置，请克隆仓库并运行python scripts/installation/install.py。

开发者设置（贡献）

为了开发和贡献，使用可编辑安装确保源代码更改立即生效：

# 克隆仓库
git clone https://github.com/doobidoo/mcp-memory-service.git
cd mcp-memory-service

# 创建并激活虚拟环境
python -m venv venv
source venv/bin/activate  # 在Windows上：venv\Scripts\activate

# CRITICAL：可编辑安装（代码更改立即生效）
pip install -e .

# 验证可编辑模式（应显示源目录，而不是site-packages）
pip show mcp-memory-service | grep Location
# 预期：Location: /path/to/mcp-memory-service/src

# 启动开发服务器
uv run memory server

⚠️ 重要：可编辑安装（-e标志）确保MCP服务器从源代码加载，而不是过期的site-packages。如果没有这个，源代码更改不会反映出来，直到重新安装包。

版本不匹配检查：

# 验证已安装版本是否与源代码匹配
python scripts/validation/check_dev_setup.py

参见CLAUDE.md以获取完整的开发指南。

传统设置选项

通用安装程序（最兼容）：

# 克隆并安装，自动检测平台
git clone https://github.com/doobidoo/mcp-memory-service.git
cd mcp-memory-service

# 轻量级安装（SQLite-vec与ONNX嵌入 - 推荐）
python install.py

# 添加完整ML功能（torch + sentence-transformers以支持高级功能）
python install.py --with-ml

# 使用混合后端安装（SQLite-vec + Cloudflare同步）
python install.py --storage-backend hybrid

📝 安装选项说明：

  • 默认（推荐）：轻量级SQLite-vec与ONNX嵌入 - 快速，离线工作，依赖项小于100MB
  • --with-ml：添加PyTorch + sentence-transformers以支持高级ML功能 - 更重但更强大
  • --storage-backend hybrid：混合后端，带有SQLite-vec + Cloudflare同步 - 最适合多设备访问

Docker（最快）：

# 对于MCP协议（Claude Desktop）
docker-compose up -d

# 对于HTTP API + OAuth（团队协作）
docker-compose -f docker-compose.http.yml up -d

Smithery（Claude Desktop）：

# 自动安装Claude Desktop
npx -y @smithery/cli install @doobidoo/mcp-memory-service --client claude

⚠️ v6.17.0+ 脚本迁移通知

**从旧版本升级？**脚本已被重组以提高可维护性：

  • 推荐：在Claude Desktop配置中使用python -m mcp_memory_service.server（无需路径依赖！）
  • 替代方案1：使用UV工具的uv run memory server
  • 替代方案2：更新路径从scripts/run_memory_server.py到scripts/server/run_memory_server.py
  • 向后兼容：旧路径仍然有效，但会有迁移通知

⚠️ 首次设置期望

首次运行时，您可能会看到一些完全正常的警告：

  • "WARNING: Failed to load from cache: No snapshots directory" - 服务正在检查缓存模型（首次设置）
  • "WARNING: Using TRANSFORMERS_CACHE is deprecated" - 提供信息的警告，不影响功能
  • 模型下载正在进行 - 服务会自动下载一个约25MB的嵌入模型（耗时1-2分钟）

这些警告在首次成功运行后会消失。服务正常工作！详情请参阅我们的首次设置指南。

🐍 Python 3.13 兼容性说明

sqlite-vec可能还没有针对Python 3.13的预构建轮。如果安装失败：

  • 安装程序会尝试多种安装方法
  • 考虑使用Python 3.12以获得最佳体验：brew install python@3.12
  • 替代方案：使用Cloudflare后端--storage-backend cloudflare
  • 详情请参阅故障排除指南

🍎 macOS SQLite扩展支持

macOS用户可能会遇到enable_load_extension错误与sqlite-vec：

  • 系统Python在macOS上默认缺乏SQLite扩展支持
  • 解决方案：使用Homebrew Python：brew install python && rehash
  • 替代方案：使用pyenv：PYTHON_CONFIGURE_OPTS='--enable-loadable-sqlite-extensions' pyenv install 3.12.0
  • 备用方案：使用Cloudflare或混合后端：--storage-backend cloudflare或--storage-backend hybrid
  • 详情请参阅故障排除指南

🎯 记忆感知实例

智能上下文注入 - 查看记忆服务如何在会话开始时自动呈现相关信息：

<img src="docs/assets/images/memory-awareness-hooks-example.png" alt="记忆感知挂钩实例" width="100%" />

您看到的是：

  • 🧠 自动记忆注入 - 从2,526条总记忆中找到8条相关记忆
  • 📂 智能分类 - 最近的工作、当前的问题、附加的上下文
  • 📊 Git感知分析 - 最近的提交和关键词自动提取
  • 🎯 相关性评分 - 最顶部的记忆评分为100%（今天）、89%（8天前）、84%（今天）
  • ⚡ 快速检索 - SQLite-vec后端，读取性能5毫秒
  • 🔄 后台同步 - 混合后端同步到Cloudflare

结果：Claude每次会话开始时都拥有完整的项目上下文 - 不需要手动提示。

📚 完整文档

👉 访问我们详尽的Wiki以获取详细的指南：

🧠 v7.1.3 自然记忆触发器（最新）

  • 自然记忆触发器 v7.1.3 指南 - 智能自动记忆感知
    • ✅ 语义模式检测触发精度超过85%
    • ✅ 多级性能（50毫秒即时 → 150毫秒快速 → 500毫秒密集型）
    • ✅ 实时配置的CLI管理系统
    • ✅ Git感知上下文集成以增强相关性
    • ✅ 动态钩子加载的零重启安装

🆕 v7.0.0 OAuth & 团队协作

🧬 v8.23.0+ 记忆合并

  • 📊 记忆合并系统指南 - **全新！**带有现实世界性能指标的自动化记忆维护
    • ✅ 灵感来源于梦境的合并（衰减评分，关联发现，压缩，归档）
    • ✅ 24/7自动调度（每天/每周/每月通过HTTP服务器）
    • ✅ 高效的代码执行API（与MCP工具相比，令牌减少90%）
    • ✅ 现实世界的性能数据（使用混合后端，2,495条记忆的合并耗时4-6分钟）
    • ✅ 三种手动触发方法（HTTP API，MCP工具，Python API）

🚀 设置与安装

🧠 高级主题