Back to MCP directory
publicPublicdnsLocal runtime

memory-mcp

Memory MCP是一个为AI助手提供持久记忆的MCP服务器,通过热缓存和冷存储两层架构,实现高频知识的零延迟自动注入和语义搜索,让Claude记住项目上下文,减少重复解释。

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许可证。

help

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client