项目简介
CycleTime是一个专门为Claude Code(Anthropic的AI编码助手)设计的MCP服务器,旨在解决大型项目开发中上下文管理和会话连续性的挑战。它通过持久化项目状态、自动追踪依赖关系和记录决策历史,让开发者可以无缝地在不同会话中恢复工作,提升与AI协作的效率和项目的可维护性。
主要功能点
- 跨会话项目连续性: 自动保存项目状态和决策历史,确保您随时从上次中断的地方继续工作,无需重复提供上下文。
- 智能依赖追踪: 自动维护任务、文件和项目组件之间的关系,提供清晰的依赖视图,帮助AI理解项目结构和下一步行动。
- MCP协议集成: 作为原生的Model Context Protocol (MCP) 服务器实现,与Claude Code直接通信,提供标准化的上下文服务。
- 嵌入式数据库: 使用高性能的H2数据库提供快速可靠的存储,无需额外安装或配置外部数据库。
- 结构化项目数据: 通过领域驱动模型管理项目、任务和工作流数据,使LLM能够更好地理解和操作项目信息。
安装步骤
CycleTime可以通过Docker或从源代码构建运行:
-
使用Docker运行 (推荐): 确保您的系统已安装Docker。 拉取并运行最新的CycleTime镜像:
docker pull ghcr.io/spiralhouse/cycletime:latest docker run -p 8080:8080 ghcr.io/spiralhouse/cycletime:latest服务器将在 'http://localhost:8080' 启动。
-
从源代码构建运行 (贡献者): 确保您的系统已安装Java 21或更高版本。 克隆仓库:
git clone https://github.com/spiralhouse/cycletime.git cd cycletime使用Gradle构建并运行:
./gradlew run服务器将在 'http://localhost:8080' 启动。
服务器配置 (供MCP客户端使用)
MCP客户端(如Claude Code)需要配置以下信息以连接到CycleTime服务器。这些配置应在客户端的MCP设置中添加,通常以JSON格式呈现。
{ "servers": { "cycletime": { "url": "http://localhost:8080/", "transport": "sse" } } }
- 'url': MCP服务器的地址,CycleTime默认在 'http://localhost:8080/' 运行。
- 'transport': 客户端与服务器通信的协议,CycleTime支持 'sse' (Server-Sent Events)。
- 关于 'command' 和 'args' 参数的说明: 在某些情况下,MCP客户端可以配置启动一个本地的MCP服务器进程。但对于CycleTime,它通常作为一个独立运行的服务(例如通过Docker或直接运行JAR文件),因此MCP客户端只需提供已启动服务器的 'url' 和 'transport' 类型即可建立连接,无需提供 'command' 和 'args'。
基本使用方法
一旦CycleTime服务器运行并通过MCP客户端配置,您可以通过LLM客户端与其交互,实现智能的项目管理和上下文感知:
- 查询任务: 向Claude Code提问:“当前有哪些任务可以开始?” - 服务器将根据项目依赖图返回未阻塞的任务列表。
- 查看项目结构: 请求Claude Code:“展示我的项目结构” - 服务器将显示当前项目的层次结构和组件之间的关系。
- 创建任务/史诗: 告知Claude Code:“创建一个关于用户认证的史诗任务” - 服务器将结构化您的工作,并将其集成到项目追踪系统中。
- 上下文恢复: 在新的会话中,Claude Code将自动从CycleTime获取完整的项目上下文,让您仿佛从未离开,避免重复输入背景信息。
信息
分类
开发者工具