关键词

代码检查点代码版本管理LLM工具AI辅助开发会话记忆

项目简介

ClaudePoint是一个基于Model Context Protocol (MCP) 的代码检查点管理后端服务。它专为与Claude Code等大型语言模型客户端集成设计，允许用户通过自然语言指令管理项目代码的版本，例如创建即时快照、查看历史记录以及安全地回退到之前的状态。ClaudePoint通过提供标准化的工具接口，为开发者在AI辅助下进行代码修改时提供了一个方便且安全的版本控制层。

主要功能点

  • 项目初始化： 在任意项目目录中设置ClaudePoint，创建必要的目录和配置文件。
  • 创建检查点： 快速保存当前项目代码的状态，支持自定义名称和描述。
  • 列出检查点： 查看项目的所有历史检查点，包括名称、时间、大小和描述。
  • 恢复检查点： 安全地回退到任意一个历史检查点，操作前会自动创建紧急备份。
  • 查看开发历史： 获取项目设置和检查点活动的完整时间线日志。
  • 添加开发日志： 允许AI或用户手动记录开发活动或代码变更详情。
  • 智能忽略： 自动读取 '.gitignore' 文件并尊重配置的忽略模式。
  • 空间效率： 使用压缩方式存储检查点。

安装步骤

  1. 确保您的系统已安装 Node.js (版本 18 或更高) 和随其附带的 NPM。
  2. 打开终端或命令行工具，运行全局安装命令： 
    npm install -g claudepoint

服务器配置

ClaudePoint作为一个MCP服务器，需要由支持MCP协议的客户端应用程序（如Claude Code或Claude Desktop）来启动和管理。客户端通过其自身的配置来定义如何连接到ClaudePoint服务。

配置信息通常包含MCP服务器的名称、启动该服务器的命令以及可能的启动参数。这些信息会被客户端用于在需要时启动ClaudePoint进程并通过标准输入/输出与其通信。

配置示例（请根据您的客户端实际配置界面或文件格式进行调整）：

  • 服务器名称 (server name): 'claudepoint' （这是客户端识别该服务的唯一名称）
  • 启动命令 (command): 'claudepoint' （这是客户端在系统终端中执行以启动ClaudePoint服务器进程的命令）
  • 启动参数 (args): 无需额外参数 （大多数情况下，直接执行 'claudepoint' 命令即可）

完成配置后，请重启您的MCP客户端应用程序，以确保加载并识别新配置的ClaudePoint服务器。

基本使用方法

在已正确安装ClaudePoint并将其配置到支持MCP的Claude Code或Claude Desktop客户端后，您无需直接使用ClaudePoint的命令行工具，而是可以通过与Claude进行自然语言对话来间接使用其功能。Claude会理解您的意图，并自动调用ClaudePoint提供的相应MCP工具。

示例对话：

  • 用户： “为这个项目设置检查点功能。”
    • Claude会调用 'setup_claudepoint' 工具
  • 用户： “在我开始重构认证系统前，创建一个检查点，请叫它‘auth-refactor-start’。”
    • Claude会调用 'create_checkpoint' 工具，并传入 'name' 和 'description' 参数
  • 用户： “列出我们所有的检查点，看看有哪些版本。”
    • Claude会调用 'list_checkpoints' 工具
  • 用户： “不小心搞砸了，恢复到那个叫做‘auth-refactor-start’的检查点。”
    • Claude会调用 'restore_checkpoint' 工具，并传入 'checkpoint' 名称
  • 用户： “我们上次会话都做了些什么？把开发历史告诉我。”
    • Claude会调用 'get_changelog' 工具
  • 用户： “记录一下：我刚刚优化了数据库查询性能。”
    • Claude会调用 'set_changelog' 工具，并传入 'description' 和可能的 'action_type' 参数

通过这种方式，您可以将ClaudePoint作为AI代码助手的强大后端，用于安全地管理您的代码实验和开发过程。

信息

分类

开发者工具

访问项目