项目简介

CycleTime是一个专门为Claude Code(Anthropic的AI编码助手)设计的MCP服务器,旨在解决大型项目开发中上下文管理和会话连续性的挑战。它通过持久化项目状态、自动追踪依赖关系和记录决策历史,让开发者可以无缝地在不同会话中恢复工作,提升与AI协作的效率和项目的可维护性。

主要功能点

  • 跨会话项目连续性: 自动保存项目状态和决策历史,确保您随时从上次中断的地方继续工作,无需重复提供上下文。
  • 智能依赖追踪: 自动维护任务、文件和项目组件之间的关系,提供清晰的依赖视图,帮助AI理解项目结构和下一步行动。
  • MCP协议集成: 作为原生的Model Context Protocol (MCP) 服务器实现,与Claude Code直接通信,提供标准化的上下文服务。
  • 嵌入式数据库: 使用高性能的H2数据库提供快速可靠的存储,无需额外安装或配置外部数据库。
  • 结构化项目数据: 通过领域驱动模型管理项目、任务和工作流数据,使LLM能够更好地理解和操作项目信息。

安装步骤

CycleTime可以通过Docker或从源代码构建运行:

  1. 使用Docker运行 (推荐): 确保您的系统已安装Docker。 拉取并运行最新的CycleTime镜像:

    docker pull ghcr.io/spiralhouse/cycletime:latest
    docker run -p 8080:8080 ghcr.io/spiralhouse/cycletime:latest

    服务器将在 'http://localhost:8080' 启动。

  2. 从源代码构建运行 (贡献者): 确保您的系统已安装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获取完整的项目上下文,让您仿佛从未离开,避免重复输入背景信息。

信息

分类

开发者工具