AI导哈

线程连续性服务器

一个自动保存和恢复Claude线程项目状态的MCP服务器，确保对话连续性并防止项目碎片化。

  • by peless
  • Python
  • 本地部署
  • 65 星标
  • 更新于
在 GitHub 查看 peless/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. 无缝继续： 从你停止的地方继续

🔧 可用命令

命令 描述 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="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使您的上下文保持有序！

相关 MCP