mcpField
M
Mindswap

Mindswap

本地服务
github.com/ShipOrBleed记忆与知识725 周前更新
代码仓库

关于 Mindswap

Mindswap 是面向开发者和编码 Agent 的本地优先上下文与记忆服务，可在不同会话间延续项目状态和决策。其命令行工具可保存、搜索记忆并生成交接简报，也能通过 MCP 与 AI 客户端共享上下文。

主要功能

  1. 01保存任务、Git 状态和决策
  2. 02通过交接简报恢复工作
  3. 03带引用搜索记忆
  4. 04管理阻碍、假设和问题
  5. 05区分项目与个人记忆范围
  6. 06在多台设备间同步状态

适用场景

  1. 01在后续会话中继续编码任务
  2. 02查找项目决策的缘由
  3. 03在不同项目间沿用个人偏好
  4. 04向 AI 客户端共享项目上下文

MCP 相关

Mindswap 通过 mcp 和 mcp-http 命令向 AI 客户端提供项目与个人上下文，并提供 MCP 安装命令。

#mcp#ai#coding-agent#developer-tools#context#memory#cli#productivity

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "mindswap": {
      "command": "npx",
      "args": [
        "-y",
        "mindswap"
      ]
    }
  }
}
启动命令npx -y mindswap

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npmmindswap3.3.0

工具

4

收录的工具列表 · 更新于 2 周前

参数类型必填说明
focusenum否关注重点："all" 表示完整上下文，"task" 表示仅当前工作，"decisions" 表示架构决策，"recent" 表示最新更改all | task | decisions | recent
compactboolean否返回令牌优化的紧凑格式（信息相同，令牌更少）

详细介绍

mindswap

npm 版本 许可证：MIT

将项目上下文和个人 AI 记忆保存在本地，让工具无需反复询问相同的上下文也能继续工作。

为什么需要它

AI 会话重置得太频繁。mindswap 会保存当前任务、决策、阻碍和交接上下文，让下一个工具能够顺利接手。

安装

npm install mindswap --save-dev

快速开始

npx mindswap init
npx mindswap
npx mindswap doctor
npx mindswap resume
npx mindswap ask "Why did we choose JWT?"

它能为你做什么

  • 使用 init 设置仓库并导入现有 AI 上下文
  • 使用 save 保存当前任务、git 状态和决策
  • 使用 doctor 检查设置是否正常以及上下文是否过时
  • 使用 resume 开始一份清晰的简报
  • 使用 ask 搜索项目记忆并获取引用
  • 使用 memory 管理阻碍、假设、问题和解决方案
  • 使用 --global 设定记忆和提问范围，在 ~/.mindswap/ 中管理个人跨工具记忆
  • 使用 reindex 从基于文件的记忆重建本地 SQLite 搜索索引
  • 使用 sync 在多台机器间共享连续性状态
  • 使用 mcp 和 mcp-http 向 AI 客户端提供相同的上下文

全局个人记忆

MindSwap 现在支持两种本地记忆范围：

  • 仓库记忆，位于 <repo>/.mindswap/
  • 个人记忆，位于 ~/.mindswap/

当某项偏好或经验需要伴随你跨项目、跨工具使用时，请使用全局记忆。

npx mindswap log "Prefer concise explanations" --type assumption --global
npx mindswap memory list --scope all
npx mindswap ask "What explanation style should we use?" --scope all
npx mindswap reindex --scope all

MCP 和 AI 工具

mindswap 会为 Claude Code、Cursor、Copilot、Codex、Windsurf、Cline、Roo、Aider、Amp、Gemini CLI 等工具以及基于 AGENTS.md 的工作流生成上下文。

npx mindswap mcp-install
npx mindswap mcp-http

项目状态

仓库的主要数据位于 .mindswap/ 中：

.mindswap/
├── HANDOFF.md
├── state.json
├── decisions.log
├── memory.json
├── config.json
├── branches/
└── history/

npm 包

使用它

如果 mindswap 能帮助你改进工作流，请为仓库加星，并持续改进交接流程。

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。