快照MCP服务器
一种模型上下文协议(MCP)服务器,用于保存和恢复具有令牌高效上下文保护的Claude对话。
这是什么?
一种模块化快照工具,可以独立工作或与更大的内存系统集成。保存会话状态,跨会话恢复工作,并以最小的令牌开销组织多个快照。
主要特点:
- 令牌高效延续提示(与原始上下文相比减少约20-30%)
- 结构化或简单的上下文输入
- 适用于克劳德桌面、克劳德代码、光标、任何MCP客户端
- 专为记忆/个性系统的可组合性而设计
安装
快速入门(推荐)
第一步: 运行安装程序:```bash
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```json
{
"mcpServers": {
"snapshot": {
"command": "npx",
"args": ["-y", "@whenmoon-afk/snapshot-mcp-server"]
}
}
}
Windows```json
{
"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
发展:bash
git clone https://github.com/WhenMoon-afk/snapshot-mcp-server.git
cd snapshot-mcp-server
npm install
npm run build
许可证
麻省理工学院
贡献
问题和PR欢迎!看 更改日志.md 版本历史。
AI助手的模块化对话状态。
