Claude Thread Continuity

🧠 Claude线程连续性MCP服务器

永远不要再失去背景！ 当Claude线程达到令牌限制时，此MCP服务器会自动保存和恢复项目状态，确保无缝的对话连续性。

🚀 特性

• 🔄 自动状态持久化 -在对话过程中自动保存项目上下文
• ⚡ 无缝恢复 -启动新线程时立即恢复完整上下文
• 🛡️ 智能验证 -通过智能名称检查防止项目碎片化
• 🔒 隐私第一 -本地存储在计算机上的所有数据
• 🎯 零配置 -一旦设置好，就可以隐形工作
• 📊 智能触发器 -自动保存文件更改、决策、里程碑
• 🗂️ 多项目支持 -管理多个并发项目

✨ 新：防碎片系统

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

• 🔍 模糊名称匹配 -检测相似的项目名称（70%相似性阈值）
• ⚠️ 验证警告 -建议在存在类似项目时进行合并
• 💪 强制超控 -当需要真正不同的项目时，绕过验证
• 🎯 可配置阈值 -调整工作流程的灵敏度

实际验证示例

❌ Project "Hebrew Speaking Evaluation MVP" blocked
✅ Similar project found: "Hebrew Evaluation MVP" (85% similar)
🎯 Recommendation: Update existing project or use force=true

⚡ 快速开始

# 1. Clone the repository
git clone https://github.com/peless/claude-thread-continuity.git
cd claude-thread-continuity

# 2. Install dependencies
pip install -r requirements.txt

# 3. Test the enhanced server
python3 test_server.py

# 4. Add to Claude Desktop config
# See setup instructions below

🛠️ 安装

1.安装MCP服务器

# Create permanent directory
mkdir -p ~/.mcp-servers/claude-continuity
cd ~/.mcp-servers/claude-continuity

# Copy files (or clone repo to this location)
# Place server.py and requirements.txt here

2.配置克劳德桌面

编辑您的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": "python3",
      "args": ["~/.mcp-servers/claude-continuity/server.py"],
      "env": {}
    }
  }
}

3.重新启动克劳德桌面

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

🎯 运作原理

自动保存上下文

在以下情况下，服务器会自动保存项目状态：

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

智能验证流程

保存前，系统：

1. 检查相似名称 -使用模糊匹配查找现有项目
2. 计算相似度 -将项目名称与70%阈值进行比较
3. 提供建议 -建议合并或重命名
4. 允许覆盖 -使用 force: true 对于边缘情况

上下文恢复

启动新线程时：

1. 加载项目： load_project_state: project_name="your-project"
2. 已还原完整上下文： 所有技术决策、文件和进度均已恢复
3. 无缝继续： 从你停止的地方继续

🔧 可用命令

💡 使用示例

启动新项目（带验证）

save_project_state: project_name="my-web-app", current_focus="Setting up React components", technical_decisions=["Using TypeScript", "Vite for bundling"], next_actions=["Create header component", "Set up routing"]

创建前检查名称

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

必要时强制覆盖

save_project_state: project_name="my-web-app-v2", force=true, current_focus="Starting version 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": "What you're working on now",
  "technical_decisions": ["Key choices made"],
  "files_modified": ["List of files created/changed"],
  "next_actions": ["Planned next steps"],
  "conversation_summary": "Brief context 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. 检查克劳德桌面日志
2. 验证Python 3是否在您的PATH中： python3 --version
3. 验证JSON配置语法
4. 完全重新启动克劳德桌面

测试增强型服务器

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           # Main MCP server (enhanced with validation)
├── requirements.txt    # Python dependencies
├── test_server.py     # Comprehensive test suite
├── README.md          # This file
├── LICENSE            # MIT License
└── examples/          # Usage examples

🤝 贡献

欢迎投稿！拜托：

1. 分叉存储库
2. 创建要素分支
3. 添加新功能的测试
4. 提交拉取请求

当前发展重点

• \[\]与外部项目管理工具集成
• \[\]高级相似性算法
• \[\]项目合并实用程序
• \[\]自定义验证规则

📄 许可证

MIT许可证-请参阅 许可证 文件以获取详细信息。

🚀 为什么这很重要

v1.1之前： 😫 命中令牌限制→ 失去所有上下文→ 重新解释一切→ 势头减弱

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

v1.1之后： 😎 命中令牌限制→ 启动新线程→ load_project_state → 无缝继续+智能验证防止碎片化

非常适合：

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

📈 版本历史记录

v1.1.0（当前）

• ✨ 项目验证系统 -通过模糊名称匹配防止碎片化
• ✨ validate_project_name 工具-手动名称检查
• ✨ 强制超控 能力-在需要时绕过验证
• ✨ 增强测试 -全面的验证测试套件
• 🐛 漏洞修补 -改进了错误处理和边缘情况

v1.0.0

• 🚀 具有核心连续性功能的初始版本

______________________________________________________________________

内置于❤️ 为克劳德社区

*厌倦了零散的项目？版本1.1使您的上下文保持有序！*