FastMCP server for bidirectional sync between personal and team Obsidian vaults

vault-sync-mcp

这是一个 FastMCP 服务，用于在个人 Obsidian 知识库与共享团队知识库之间进行双向同步。它适用于这样的团队：由一人（知识库所有者）维护唯一可信来源，并通过共享文件夹（Google Drive、Dropbox 等）与协作者分享选定内容。

工具

推送和拉取操作默认都设置为 dry_run: true，执行前始终可以预览。

安装

打开 Claude Code，粘贴：

/plugin marketplace add adelaidasofia/vault-sync-mcp
/plugin install vault-sync-mcp@vault-sync-mcp

然后编辑 config.yaml，设置知识库路径和同步规则：

personal_vault: ~/vault/
team_vault: ~/team-vault/

重启 Claude Code。然后询问：

“显示知识库同步状态” “将更改推送到团队知识库（先试运行）”

pip install fastmcp python-frontmatter pyyaml xxhash

配置

所有配置都在 config.yaml 中：

personal_vault: ~/vault/
team_vault: ~/team-vault/

no_sync:
  - "Journal/"
  - "Personal/"

sync_rules:
  - path: "Team/"
    direction: bidirectional

  - path: "CRM/"
    direction: personal_to_team
    filter:
      frontmatter_field: relationship
      frontmatter_values: [client, team, advisor]

同步规则方向

• bidirectional — 更改双向流动
• personal_to_team — 个人知识库为唯一可信来源，团队知识库接收更新
• team_to_personal — 团队知识库为唯一可信来源，个人知识库接收更新（适用于共享文档）

阻止同步某个文件

在任意文件的 frontmatter 中添加 sync: false，即可将其排除在所有同步操作之外。

环境变量

备注

• 使用 os.walk(followlinks=True) 而非 Path.rglob()，以正确处理 macOS 符号链接（Google Drive、iCloud 快捷方式）
• 推送时会自动将 Wiki 链接改写为纯文件名（[[folder/Note]] 会变为 [[Note]]）
• 使用 xxhash 对内容进行哈希，以快速检测更改
• 冲突解决方式：以较新的文件为准；冲突会记录日志并跳过

相关 MCP

同一作者，采用相同的架构模式（FastMCP、适用时写入前先草拟并确认、自动导出到 vault、MIT）：

• slack-mcp - 多工作区 Slack
• imessage-mcp - macOS iMessage
• whatsapp-mcp - 通过 whatsmeow 使用 WhatsApp
• google-workspace-mcp - Gmail / Calendar / Drive / Docs / Sheets
• apollo-mcp - Apollo.io CRM + 序列
• substack-mcp - Substack 写作 + 分析
• luma-mcp - lu.ma 活动
• parse-mcp - markitdown / Docling / LlamaParse 路由器
• rescuetime-mcp - RescueTime 效率数据
• graph-query-mcp - vault 知识图谱查询
• graph-autotagger-mcp - 根据知识图谱提供维基链接建议
• investor-relations-mcp - 种子轮融资流程跟踪器

遥测

此插件在某台机器上首次于 Claude Code 会话中加载时，会向 myceliumai.co 发送一条匿名安装信号。

发送的内容：

• 插件名称（例如 slack-mcp）
• 插件版本（例如 0.1.0）

不会发送的内容：

• 不包含用户标识符、姓名、电子邮件、令牌或 API 密钥
• 不包含文件路径、消息内容或任何工作相关信息
• 去重处理后不会存储 IP 地址

原因： 帮助维护者了解用户实际安装了哪些插件，以便将精力投入到有人使用的插件上。

选择退出： 在启动 Claude Code 前设置环境变量 MYCELIUM_NO_PING=1。此钩子将完全跳过网络请求。已发送信号的安装会在 ~/.mycelium/onboarded-<plugin> 留下一个标记文件——如果要重置状态，请将其删除。

许可证

MIT

由 Mycelium AI 构建。完整安装或团队版本请访问 diazroa.com。