Claude Continuity MCP Server

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 files

2.安装依赖项

cd ~/claude-continuity
pip3 install mcp

3.配置克劳德桌面

编辑您的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: 
  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
}

故障排除

服务器未连接

1. 检查Python安装：

python3 --version
# Should be 3.8 or higher

1. 直接测试服务器：

python3 ~/claude-continuity/server.py
# Should show: "Claude Continuity Server initialized..."

1. 检查Claude Desktop日志是否有错误

权限问题

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

Python路径问题

更新配置以使用完整的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

运作原理

1. 自动检测：服务器监视与项目相关活动的对话
2. 智能储蓄：在覆盖状态之前自动创建备份
3. 上下文保护：维护文件、决策、问题和下一步行动
4. 无缝恢复：使用一个命令加载整个项目上下文

贡献

欢迎投稿！拜托：

1. 分叉存储库
2. 创建要素分支
3. 测试您的更改
4. 提交拉取请求

许可证

MIT许可证-有关详细信息，请参阅许可证文件

作者

为Claude社区创建，旨在一劳永逸地解决上下文丢失问题。

支持

对于问题或疑问：

• 在GitHub上打开一个问题
• 检查现有问题的解决方案

______________________________________________________________________

之前: 😫 命中令牌限制→ 失去所有上下文→ 重新解释一切\ 之后: 😎 命中令牌限制→ 启动新线程→ load_project_state → 无缝继续