项目简介

Mind 是一个基于 Model Context Protocol (MCP) 构建的智能记忆服务器,专门为 Claude 等 AI 助手设计。它解决了 AI 在编程会话中容易忘记之前决策、学习经验和失败尝试的问题,通过自动化的记忆管理帮助 AI 更高效地工作。

主要功能

  • 双层记忆系统

    • MEMORY.md:长期记忆,保存决策、学习、问题和进展
    • SESSION.md:短期焦点,记录当前会话的经验、阻碍、被拒绝方法和假设
  • 自动记忆管理

    • 会话间隙自动检测(30分钟)
    • 有价值的经验自动从会话记忆提升到长期记忆
    • 上下文自动注入到 CLAUDE.md
    • 提醒功能(时间触发和关键词触发)
  • 12个MCP工具

    • 核心:'mind_recall()'(每次会话首先调用)、'mind_log()'(根据类型路由到不同文件)

安装步骤

  1. 使用 pip 安装:
pip install vibeship-mind
  1. 在项目目录中初始化:
python -m mind init
  1. 配置MCP客户端连接Mind服务器

服务器配置

将以下配置添加到您的MCP客户端配置文件中:

{
  "mcpServers": {
    "mind": {
      "command": "python",
      "args": ["-m", "mind", "mcp"]

配置说明:

  • server name:'mind'(客户端通过此名称识别服务器)
  • command:'python'(使用Python解释器)
  • args:'["-m", "mind", "mcp"](运行mind模块的mcp命令)

基本使用

安装配置完成后,Mind 会自动工作:

  • Claude 在会话中会自动记录重要信息到 SESSION.md
  • 当会话间隙超过30分钟时,系统自动将重要内容从SESSION.md提升到MEMORY.md
  • 每次新会话开始时,'mind_recall()' 会自动加载长期记忆作为上下文
  • 当您提到特定关键词时,相关的提醒会自动浮现

核心工具包括:

  • 'mind_search()':语义搜索过去的记忆
  • 'mind_blocker()':记录阻碍并自动搜索解决方案
  • 'mind_remind()':设置时间或上下文相关的提醒

信息

分类

开发者工具