Claude连续性MCP服务器
一种模型上下文协议（MCP）服务器，为Claude Desktop和Claude Code提供持久内存和对话连续性。当线程达到令牌限制时，永远不要再丢失项目上下文。
特性
- 🔄 自动状态持久化 -保存项目上下文和对话状态
- ⚡ 无缝恢复 -启动新线程时立即恢复完整上下文
- 🔒 隐私第一 -所有数据都存储在本地
~/.claude_states - 📊 多项目支持 -管理多个并发项目
- 🗂️ 智能组织 -自动备份轮换和状态管理
- 🎯 零配置 -设置后立即工作
安装
1.克隆或下载
# Clone to your home directory
cd ~
git clone https://github.com/yourusername/claude-continuity.git
# Or download and extract the files2.安装依赖项
cd ~/claude-continuity
pip3 install mcp3.配置克劳德桌面
编辑您的Claude Desktop配置：
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - 视窗:
%APPDATA%\Claude\claude_desktop_config.json - Linux:
~/.config/Claude/claude_desktop_config.json
添加此配置：
{
"mcpServers": {
"claude-continuity": {
"command": "/opt/homebrew/bin/python3.11",
"args": ["/Users/yourusername/claude-continuity/server.py"],
"env": {}
}
}
}4.配置克劳德代码
运行此命令以全局添加：
claude mcp add --scope user claude-continuity python3 ~/claude-continuity/server.py用法
可用工具
| 工具 | 说明 |
|---|---|
save_project_state | 保存当前项目上下文和状态 |
load_project_state | 还原已保存的项目上下文 |
list_active_projects | 查看所有跟踪的项目 |
get_project_summary | 无需加载完整状态即可快速浏览 |
delete_project_state | 拆除项目（有安全确认） |
update_project_context | 仅更新上下文/元数据 |
示例用法
保存项目状态：
save_project_state:
project_name="my-web-app"
state={current work and context}
summary="Setting up authentication system"
context={files_modified, issues, next_steps}加载项目状态：
load_project_state: project_name="my-web-app"列出所有项目：
list_active_projects数据存储
所有项目状态都存储在本地：
~/.claude_states/
├── project-name-1/
│ ├── state.json
│ ├── summary.txt
│ └── state.backup.*.json
└── project-name-2/
├── state.json
├── summary.txt
└── state.backup.*.json国家结构
每个保存的状态包括：
{
"project_name": "my-project",
"state": {
// Your custom state object
},
"summary": "Human-readable summary",
"context": {
"files_modified": [],
"issues": [],
"next_steps": [],
"dependencies": []
},
"updated_at": "2025-08-05T22:48:00Z",
"version": 1
}故障排除
服务器未连接
- 检查Python安装：
python3 --version
# Should be 3.8 or higher- 直接测试服务器：
python3 ~/claude-continuity/server.py
# Should show: "Claude Continuity Server initialized..."- 检查Claude Desktop日志是否有错误
权限问题
chmod +x ~/claude-continuity/server.pyPython路径问题
更新配置以使用完整的Python路径：
{
"command": "/usr/bin/python3",
"args": ["/Users/yourusername/claude-continuity/server.py"]
}需求
- Python 3.8+
- MCP-SDK(
pip install mcp) - 克劳德桌面或克劳德代码
项目结构
claude-continuity/
├── server.py # Main MCP server
├── requirements.txt # Python dependencies
├── README.md # This file
├── LICENSE # MIT License
└── .gitignore # Git ignore file运作原理
- 自动检测：服务器监视与项目相关活动的对话
- 智能储蓄：在覆盖状态之前自动创建备份
- 上下文保护：维护文件、决策、问题和下一步行动
- 无缝恢复：使用一个命令加载整个项目上下文
贡献
欢迎投稿！拜托：
- 分叉存储库
- 创建要素分支
- 测试您的更改
- 提交拉取请求
许可证
MIT许可证-有关详细信息，请参阅许可证文件
作者
为Claude社区创建，旨在一劳永逸地解决上下文丢失问题。
支持
对于问题或疑问：
- 在GitHub上打开一个问题
- 检查现有问题的解决方案
______________________________________________________________________
之前: 😫 命中令牌限制→ 失去所有上下文→ 重新解释一切\ 之后: 😎 命中令牌限制→ 启动新线程→ load_project_state → 无缝继续