AI导哈

对话快照服务器

一个用于保存和恢复Claude对话的模型上下文协议服务器，具有高效的令牌保存功能。

  • by WhenMoon-afk
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 WhenMoon-afk/snapshot-mcp-server

使用说明

快照MCP服务器

一种模型上下文协议（MCP）服务器，用于保存和恢复具有令牌高效上下文保护的Claude对话。

这是什么？

一种模块化快照工具，可以独立工作或与更大的内存系统集成。保存会话状态，跨会话恢复工作，并以最小的令牌开销组织多个快照。

主要特点：

  • 令牌高效延续提示（与原始上下文相比减少约20-30%）
  • 结构化或简单的上下文输入
  • 适用于克劳德桌面、克劳德代码、光标、任何MCP客户端
  • 专为记忆/个性系统的可组合性而设计

安装

快速入门（推荐）

第一步： 运行安装程序：

npx @whenmoon-afk/snapshot-mcp-server

第二步： 重新启动Claude Desktop（退出并完全重新打开）

就是这样！安装程序会自动配置您的Claude Desktop。

手动设置

如果您更喜欢手动配置，请添加到您的Claude Desktop配置文件中：

配置文件位置：

  • macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
  • 窗户： %APPDATA%\Claude\claude_desktop_config.json
  • Linux： ~/.config/Claude/claude_desktop_config.json

配置：

macOS/Linux 
{
  "mcpServers": {
    "snapshot": {
      "command": "npx",
      "args": ["-y", "@whenmoon-afk/snapshot-mcp-server"]
    }
  }
}
Windows 
{
  "mcpServers": {
    "snapshot": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "@whenmoon-afk/snapshot-mcp-server"]
    }
  }
}

注： Windows需要 cmd /c 包装器正确执行npx。

然后重新启动Claude Desktop。

用法

保存快照：

Save a snapshot with:
- summary: "Built REST API"
- context: "Express server, MongoDB, all CRUD working"
- next_steps: "Add auth"

恢复工作：

Load latest snapshot

命名快照：

Save snapshot named "v1-complete" with summary: "MVP deployed" and context: "..."
Load snapshot named "v1-complete"

管理：

List all snapshots
Delete snapshot 5

特性

  • 令牌高效提示 -预先生成、优化的继续提示
  • 灵活的上下文 -简单字符串或结构化对象
  • 命名快照 -保存里程碑以便于检索
  • 跨客户 -适用于克劳德桌面、克劳德代码、光标等。
  • 可组合 -与记忆/个性系统集成
  • 本地存储 -您的数据保留在您的计算机上（SQLite）

结构化上下文示例：

context: {
  files: ["src/auth.ts"],
  decisions: ["JWT with 24h expiration"],
  blockers: ["Need email verification"],
  code_state: { tests_passing: true }
}

工具

  • save_snapshot -保存对话状态
  • load_snapshot -从快照恢复（最新、按ID或按名称）
  • list_snapshots -查看所有快照
  • delete_snapshot -删除快照

工作流示例

一天结束：

Save a snapshot:
- summary: "Implemented JWT auth"
- context: "Login/signup working, JWT middleware done, tests passing"
- next_steps: "Add password reset"

下次会议：

Load latest snapshot

克劳德继续讲述全部内容。

故障排除

工具未显示？

  1. 完全重新启动Claude Desktop（退出并重新打开）
  2. 验证配置文件是否正确
  3. 确保已安装Node.js 18+： node --version

服务器问题？

  • 重新安装： npx @whenmoon-afk/snapshot-mcp-server
  • 检查客户端日志是否有错误
  • 重置：删除配置条目并重新安装

技术细节

堆栈： SQLite+TypeScript+MCP SDK 1.0.4（Node.js 18+）

数据库位置：

  • macOS： ~/.claude-snapshots/snapshots.db
  • 窗户： %APPDATA%/claude-snapshots/snapshots.db
  • Linux： ~/.local/share/claude-snapshots/snapshots.db

发展：

git clone https://github.com/WhenMoon-afk/snapshot-mcp-server.git
cd snapshot-mcp-server
npm install
npm run build

许可证

麻省理工学院

贡献

问题和PR欢迎！看 更改日志.md 版本历史。

AI助手的模块化对话状态。

相关 MCP