🧠 Claude 线程连续性 MCP 服务器

**再也不丢失上下文！**此MCP服务器在Claude线程达到令牌限制时自动保存并恢复项目状态，确保对话无缝延续。

🚀 特性

• 🔄 自动状态持久化 - 在对话过程中自动保存项目上下文
• ⚡ 无缝恢复 - 开始新线程时立即恢复完整上下文
• 🛡️ 智能验证 - 使用智能名称检查防止项目碎片化
• 🔒 首重隐私 - 所有数据存储在您的本地机器上
• 🎯 零配置 - 设置后无需额外操作即可运行
• 📊 智能触发器 - 文件更改、决策、里程碑时自动保存
• 🗂️ 多项目支持 - 管理多个并发项目

✨ 新功能：防碎片化系统

版本1.1引入了智能项目验证以防止意外创建多个相似项目的常见问题：

• 🔍 模糊名称匹配 - 检测相似项目名称（70%相似度阈值）
• ⚠️ 验证警告 - 当存在相似项目时建议合并
• 💪 强制覆盖 - 当确实需要不同项目时绕过验证
• 🎯 可配置阈值 - 根据工作流程调整敏感度

示例验证过程

❌ 项目 "希伯来语评估 MVP" 被阻止
✅ 发现相似项目："希伯来评估 MVP"（85%相似）
🎯 建议：更新现有项目或使用 force=true

⚡ 快速开始

# 1. 克隆仓库
git clone https://github.com/peless/claude-thread-continuity.git
cd claude-thread-continuity

# 2. 安装依赖
pip install -r requirements.txt

# 3. 测试增强服务器
python3 test_server.py

# 4. 添加到 Claude Desktop 配置
# 请参阅下面的设置说明

🛠️ 安装

1. 安装MCP服务器

# 创建永久目录
mkdir -p ~/.mcp-servers/claude-continuity
cd ~/.mcp-servers/claude--continuity

# 复制文件（或将仓库克隆到此位置）
# 将 server.py 和 requirements.txt 放在这里

2. 配置 Claude Desktop

编辑您的 Claude Desktop 配置文件：

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\\Claude\\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

添加以下配置：

{
  "mcpServers": {
    "claude-continuity": {
      "command": "python3",
      "args": ["~/.mcp-servers/claude-continuity/server.py"],
      "env": {}
    }
  }
}

3. 重启 Claude Desktop

关闭并重新打开 Claude Desktop。现在连续性工具将自动可用。

🎯 工作原理

自动上下文保存

当以下情况发生时，服务器会自动保存项目状态：

• ✅ 文件被创建或修改
• ✅ 技术决策被做出
• ✅ 达到项目里程碑
• ✅ 每10条消息（备用）

智能验证过程

在保存之前，系统会：

1. 检查相似名称 - 使用模糊匹配查找现有项目
2. 计算相似度 - 比较项目名称，70%阈值
3. 提供建议 - 建议合并或重命名
4. 允许覆盖 - 使用 force: true 处理特殊情况

上下文恢复

开始新线程时：

1. 加载项目：load_project_state: project_name="your-project"
2. 完全恢复上下文：所有技术决策、文件和进度恢复
3. 无缝继续：从上次离开的地方继续

🔧 可用命令

命令	描述	新增于v1.1
save_project_state	保存当前项目状态	✨ 现包含验证
load_project_state	恢复完整项目上下文
list_active_projects	查看所有跟踪的项目
get_project_summary	获取快速项目概览
validate_project_name	检查相似项目名称	✨ 新增
auto_save_checkpoint	自动触发

💡 使用示例

开始新项目（含验证）

save_project_state: project_name="my-web-app", current_focus="设置React组件", technical_decisions=["使用TypeScript", "使用Vite打包"], next_actions=["创建头部组件", "设置路由"]

创建前检查名称

validate_project_name: project_name="my-webapp", similarity_threshold=0.7

需要时强制覆盖

save_project_state: project_name="my-web-app-v2", force=true, current_focus="开始版本2"

达到令牌限制后继续

load_project_state: project_name="my-web-app"

查看所有项目

list_active_projects

🗂️ 数据存储

项目状态存储在本地：

~/.claude_states/
├── project-name-1/
│   ├── current_state.json
│   └── backup_*.json
└── project-name-2/
    ├── current_state.json
    └── backup_*.json

• 隐私：一切保留在您的机器上
• 备份：自动备份轮换（保留最后5个）
• 格式：人类可读的JSON文件
• 验证：元数据追踪验证绕过状态

🏗️ 项目状态结构

每个保存的状态包括：

{
  "project_name": "my-project",
  "current_focus": "您正在做什么",
  "technical_decisions": ["关键选择"],
  "files_modified": ["创建/更改的文件列表"],
  "next_actions": ["计划的下一步"],
  "conversation_summary": "简短上下文总结",
  "last_updated": "2025-06-15T10:30:00Z",
  "version": "1.1",
  "validation_bypassed": false
}

🛡️ 验证配置

默认设置

• 相似度阈值：70%（0.7）
• 比较方法：模糊字符串匹配
• 自动保存行为：绕过验证（使用 force=true）

自定义验证

validate_project_name: project_name="test-project", similarity_threshold=0.8

更高阈值 = 更严格的匹配（0.9 = 需要90%相似） 更低阈值 = 更宽松的匹配（0.5 = 50%相似触发警告）

🔍 故障排除

工具未出现

1. 检查 Claude Desktop 日志
2. 验证 Python 3 是否在您的 PATH 中：python3 --version
3. 验证 JSON 配置语法
4. 完全重启 Claude Desktop

测试增强服务器

cd ~/.mcp-servers/claude-continuity
python3 test_server.py

测试套件现在包括验证测试，并报告：

• ✅ 基本功能测试
• ✅ 项目验证测试
• ✅ 模糊匹配准确性
• ✅ 强制覆盖功能

常见问题

验证太严格： 降低相似度阈值或使用 force=true

权限错误：

chmod +x ~/.mcp-servers/claude-continuity/server.py

Python路径问题： 更新配置以使用完整的Python路径：

{
  "command": "/usr/bin/python3",
  "args": ["~/.mcp-servers/claude-continuity/server.py"]
}

🧪 开发

要求

• Python 3.8+
• MCP SDK 1.0+
• difflib（内置，用于模糊匹配）

运行测试

python3 test_server.py

增强测试套件包括：

• 基本功能验证
• 新增：项目名称相似性测试
• 新增：验证工作流测试
• 新增：强制覆盖测试
• 新增：MCP工具验证

项目结构

claude-thread-continuity/
├── server.py           # 主MCP服务器（增强版，带验证）
├── requirements.txt    # Python依赖
├── test_server.py     # 综合测试套件
├── README.md          # 本文档
├── LICENSE            # MIT许可证
└── examples/          # 使用示例

🤝 贡献

欢迎贡献！请：

1. 分叉仓库
2. 创建功能分支
3. 为新功能添加测试
4. 提交拉取请求

当前开发优先级

• 与外部项目管理工具集成
• 高级相似算法
• 项目合并工具
• 自定义验证规则

📄 许可

MIT许可 - 详情见LICENSE文件。

🚀 为什么这很重要

在v1.1之前： 😫 达到令牌限制 → 丢失所有上下文 → 重新解释一切 → 失去动力

常见问题： 😤 创建“希伯来MVP”，然后“希伯来评估MVP”，然后“希伯来口语MVP” → 上下文分散在多个项目中

在v1.1之后： 😎 达到令牌限制 → 开始新线程 → load_project_state → 无缝继续 + 智能验证防止碎片化

适用于：

• 🏗️ 复杂开发项目 - 跟踪架构决策而不碎片化
• 📚 学习与研究 - 在一致命名的学习会话中保持上下文
• ✍️ 写作项目 - 记住情节要点而不创建重复的角色项目
• 🔧 多会话调试 - 清晰的项目组织保存调试状态

📈 版本历史

v1.1.0（当前）

• ✨ 项目验证系统 - 使用模糊名称匹配防止碎片化
• ✨ validate_project_name 工具 - 手动名称检查
• ✨ 强制覆盖 功能 - 需要时绕过验证
• ✨ 增强测试 - 综合验证测试套件
• 🐛 错误修复 - 改进错误处理和边缘案例

v1.0.0

• 🚀 初始发布，核心连续性功能

---

为Claude社区打造 ❤️

厌倦了碎片化的项目？版本1.1让您的上下文保持有序！