mcpField
C
context-sync

context-sync

本地服务
github.com/Intina47记忆与知识18929 周前更新
代码仓库

关于 context-sync

Context Sync 是本地优先的项目记忆 MCP 服务，为 AI 编码工具保存项目身份、技术栈、决策和进行中的工作，使会话能够延续。面向使用多种 AI 编码客户端的开发者。

主要功能

  1. 01项目上下文的持久化存储
  2. 02决策与约束的记录与检索
  3. 03结构化文件浏览与搜索
  4. 04基于 git 的上下文信息
  5. 05可选的 Notion 只读查询
  6. 06git 钩子自动捕获上下文

适用场景

  1. 01在新会话开始时恢复项目背景与待办工作
  2. 02记录架构决策，供之后的会话参考
  3. 03在多个 AI 编码工具之间共享同一项目记忆

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "intina47-context-sync": {
      "command": "npx",
      "args": [
        "-y",
        "@context-sync/server"
      ]
    }
  }
}
启动命令npx -y @context-sync/server

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npm@context-sync/server1.0.1

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

Context Sync

通过 MCP 为 AI 编码工具提供本地优先的项目记忆。

Context Sync 为代码库中的 Agent 提供持久记忆层：

  • 项目身份和技术栈
  • 当前工作、决策、限制和注意事项
  • 结构化文件探索
  • 感知 Git 的上下文
  • 可选的只读 Notion 查询

Context Sync

功能

Context Sync 专为会话连续性而构建。它不会依赖模型记住之前的对话，而是存储重要的项目上下文，并通过一组精简的 MCP 工具让这些内容可供检索。

当前的核心工具包括：

  • set_project
  • remember
  • recall
  • read_file
  • search
  • structure
  • git
  • notion

安装

全局安装：

npm install -g @context-sync/server

全局安装期间会自动进行配置。安装后，请重启你的 AI 工具。

如果你选择本地安装而非全局安装，则不会自动配置。请参阅 docs/CONFIG.md 中的手动配置指南。

验证

检查 MCP 工具列表中是否出现 context-sync：

  • Claude Desktop：打开工具列表
  • Cursor：打开工具列表
  • VS Code / Copilot Chat Agent 模式：检查工具
  • Continue.dev：打开 Continue 面板
  • Codex CLI：codex mcp list
  • Claude Code：claude mcp list

如果自动配置失败，请参阅 docs/TROUBLESHOOTING.md 和 docs/CONFIG.md。

可选的 Notion 设置

如果你需要 Notion 集成，请运行设置向导：

context-sync-setup

或：

npx context-sync-setup

Notion 支持在工具层面刻意设为只读：

  • notion({ action: "search", query: "..." })
  • notion({ action: "read", pageId: "..." })

首次使用工作流

每次开始新会话时，都先设置项目：

1. set_project({ path: "/absolute/path/to/project" })
2. recall()
3. structure({ depth: 2 })
4. read_file({ path: "src/index.ts" })
5. remember({ type: "decision", content: "Use SQLite for local storage" })

推荐用法：

  • 每个项目／会话开始时调用一次 set_project
  • 使用 recall 恢复上下文
  • 使用 structure 和 search 进行探索
  • 使用 read_file 进行针对性检查
  • 当某些内容需要保留到当前会话之后时，使用 remember

Git 集成

在 Git 仓库中运行 set_project 时，Context Sync 可以安装钩子以自动捕获上下文。

已安装的钩子：

  • post-commit
  • pre-push
  • post-merge
  • post-checkout

钩子会标记为 Context Sync Auto-Hook，并且会先备份现有钩子。

git 工具支持：

  • status
  • context
  • hotspots
  • coupling
  • blame
  • analysis

数据和配置

默认位置：

  • 数据库：~/.context-sync/data.db
  • 配置：~/.context-sync/config.json
  • 安装状态：~/.context-sync/install-status.json

自定义数据库选项：

  • CLI：context-sync --db-path /absolute/path/to/db
  • 环境变量：CONTEXT_SYNC_DB_PATH

存储详情请参阅 docs/DATA.md。

支持的平台

  • Claude Desktop
  • Cursor
  • VS Code + GitHub Copilot
  • Continue.dev
  • Zed
  • Windsurf
  • Codeium
  • TabNine
  • Codex CLI
  • Claude Code
  • Antigravity

文档

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。