快照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克劳德继续讲述全部内容。
故障排除
工具未显示？
- 完全重新启动Claude Desktop（退出并重新打开）
- 验证配置文件是否正确
- 确保已安装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助手的模块化对话状态。