项目简介

Context Sync是一个Model Context Protocol (MCP) 服务器，它旨在解决大型语言模型（如Anthropic Claude）在不同聊天会话之间缺乏记忆的痛点。通过自动保存项目信息、技术决策、对话记录等上下文，Context Sync让您的AI助手在所有对话中都能保持对您工作内容的完美记忆，无需重复解释。它专注于开发者工作流，提供项目管理和代码库交互功能，所有数据均本地存储，确保隐私安全。

主要功能点

• 跨会话记忆: 无论开启多少个新聊天，AI助手都能记住您之前的项目、决策和对话。
• 项目上下文管理: 自动跟踪您当前工作的项目名称、技术栈、架构决策等。
• 决策历史记录: 智能保存重要的技术选择及其原因，方便日后回顾。
• 会话归档: 自动保存关键对话片段，避免信息丢失。
• 代码库理解 (Workspace Features): 允许AI助手读取项目文件夹中的文件、理解目录结构、扫描代码库并提供上下文感知的代码协助，无需手动复制粘贴。
• Git 集成: 提供获取Git状态、查看代码差异、建议提交信息等版本控制辅助功能。
• 文件操作: 支持安全的文件创建、修改和删除（需用户批准），并提供撤销功能。
• 本地优先: 所有数据都存储在您的本地机器上，确保数据隐私和安全。
• 零配置: 提供简单的安装脚本，可自动配置Claude桌面版。

安装步骤

推荐使用npm进行全局安装：

1. 安装Context Sync服务器：

   npm install -g @context-sync/server
   

   这个命令会自动安装服务器并尝试配置Claude桌面版。
2. （可选）如果全局安装失败或希望从源代码安装：

   # 克隆仓库
   git clone https://github.com/Intina47/context-sync.git
   cd context-sync
   
   # 运行通用设置脚本
   node setup.js
   

   该脚本会安装依赖、构建项目并自动配置Claude桌面版。
3. 重启Claude桌面版：
   • Mac: 按 'Cmd+Q' 退出，然后重新打开。
   • Windows: 右键任务栏托盘图标 → 退出，然后重新打开。
   • Linux: 关闭并重新打开应用程序。

服务器配置

Context Sync作为一个MCP服务器，需要被MCP客户端（如Claude桌面版）识别和启动。安装脚本会自动完成以下配置，您通常无需手动操作。

Claude桌面版会在其配置文件中注册Context Sync服务器，以便在需要时启动它。该配置文件中会添加类似以下内容：

• 服务器名称 (server name): 'context-sync'
• 启动命令 (command): 'node'
• 启动参数 (args): '/absolute/path/to/context-sync/dist/index.js' (这是一个指向Context Sync服务器实际入口文件的绝对路径)

注意： 您只需确保安装成功并重启Claude即可，不必手动编辑此文件。MCP客户端会根据上述信息来启动并连接到Context Sync服务器。

基本使用方法

1. 初始化或切换项目： 在Claude聊天中输入：'Initialize a project called "my-app" with React and TypeScript' Claude会响应：'Project "my-app" initialized and set as active.'
2. 记录决策： 继续输入：'We decided to use Zustand for state management' Claude会响应：'Decision saved.'
3. 验证跨会话记忆： 打开一个全新的Claude聊天，然后输入：'What project am I working on?' Claude会响应：'You're working on "my-app" (React + TypeScript), and you recently decided to use Zustand for state management.' （AI助手记住了您在另一个聊天中设定的项目和决策！）
4. 设置工作区并阅读文件： 在Claude聊天中输入：'Set workspace to /Users/me/my-app' (将路径替换为您的项目根目录) Claude会响应已设置工作区，并可能显示项目结构预览。 然后输入：'Read src/components/Header.tsx' Claude会显示该文件的内容。