金大哥 - memory-mcp MCP 详情

article

README

🚀 🧠 内存MCP

Memory MCP 为你的AI助手赋予持久的“第二大脑”，解决每次会话都需重新解释项目的困扰，能自动学习重要信息并即时调取常用内容，还支持语义搜索。

🚀 快速开始

Memory MCP 可让你告别每次会话都重新解释项目的繁琐。它能学习重要信息并随时准备好，常用内容可即时调取，其他内容也能通过语义搜索获取。

✨ 主要特性

两层架构优化：采用两层架构，热缓存（0ms）自动注入常用知识，无需工具调用；冷存储（~50ms）可通过语义相似性搜索其他内容。
自动学习与提升：系统能自动学习你使用的内容并进行提升，无需手动管理。
多方面优势显著：与通用内存服务器相比，具有热缓存自动注入、自组织、项目感知、知识图谱、模式挖掘、信任评分和简易设置等优势。

📦 安装指南

# 安装包
uv tool install hot-memory-mcp   # 或者: pip install hot-memory-mcp

# 添加插件（推荐）
claude plugins add michael-denyer/memory-mcp

该插件会为你提供自动配置的钩子、斜杠命令和内存分析代理。在苹果硅芯片上会自动检测MLX。

手动配置（不使用插件）

添加到 ~/.claude.json：

{
  "mcpServers": {
    "memory": {
      "command": "memory-mcp"
    }
  }
}

完整的配置选项请参阅参考文档。

重启Claude Code。热缓存会自动从你的项目文档中填充。

首次运行：嵌入模型（~90MB）会自动下载，仅需30 - 60秒。

💻 使用示例

基础用法

Memory MCP 设计为三个互补组件运行： | 组件 | 用途 | |-----------|---------| | Claude Code插件 | 提供钩子、斜杠命令和内存分析代理，实现无缝集成 | | MCP服务器 | 通过模型上下文协议为Claude提供核心内存工具 | | 仪表盘 | 用于浏览、管理和调试内存数据库的Web界面 |

大多数用户推荐使用插件，它会自动配置MCP服务器并添加提高生产力的功能。当你想查看存储内容时，可以同时运行仪表盘。

高级用法

斜杠命令使用

| 斜杠命令 | 工具 | 描述 | |---------------|------|-------------| | /memory-mcp:remember | remember | 使用语义嵌入存储记忆 | | /memory-mcp:recall | recall | 按含义搜索记忆 | | /memory-mcp:hot-cache | promote / demote | 管理提升的记忆 | | /memory-mcp:stats | memory_stats | 显示统计信息 | | /memory-mcp:bootstrap | bootstrap_project | 从项目文档中初始化 | | — | link_memories | 知识图谱连接 |

完整的14个斜杠命令和工具API请参阅参考文档。

仪表盘使用

memory-mcp-cli dashboard    # 在 http://localhost:8765 打开

仪表盘

你可以在仪表盘中浏览记忆、热缓存、挖掘候选、会话和知识图谱。

📚 详细文档

| 文档 | 描述 | |----------|-------------| | 参考文档 | 完整的API、CLI、配置和MCP资源 | | 故障排除 | 常见问题及解决方案 |

📄 许可证

本项目采用MIT许可证。

memory-mcp