Posted in使用手册 新闻

让 AI Agent 理解网盘资源

让 AI Agent 理解网盘资源

摘要: 你的 AI Agent 很聪明，但它通常是个“瞎子”——它看不见你存在网盘里的几千本 PDF，也读不懂你 Obsidian 里积累多年的私有笔记。今天，我们通过 Sync Vault MCP Server，让Claude Code访问网盘资源。

Sync Vault + MCP 协议

Model Context Protocol (MCP) 是 Anthropic 推出的一个开放标准，旨在让 AI 模型能够以安全、标准化的方式访问外部数据。

我们在 Obsidian Sync Vault 插件中内置了一个轻量级的 MCP Server。它就像一个翻译官，把你的 Obsidian 仓库和绑定的云盘，变成 AI 可以理解的“工具”。

核心能力

开启 Sync Vault 的 MCP 服务后，你的 Claude Code 或 Cursor 就能获得以下超能力：

1. 🔍 云端文件“透视眼” (`search_cloud_files`)

AI 可以直接搜索你绑定的网盘（支持阿里云盘、百度网盘、S3 等）。

用户: “帮我找一下网盘里关于 Rust 语言的书。”

AI: (调用工具) 找到了 `/技术书籍/Rust/Rust程序设计.pdf` 和 `/归档/Rust实战.pdf`。

2. 📖 云端大文件“秒读” (`read_cloud_file`)

这是最激动人心的功能。AI 可以 直接读取 云端文件的内容，无需你下载到本地。

  • 智能流式读取：对于 500MB 的 PDF，AI 不会傻傻地下载整个文件。Sync Vault 实现了智能分片（Range Request），AI 可以只读取前 50KB 生成摘要，或者精准读取某一章。
  • 格式自适应：自动提取 PDF 文本，解析 Markdown、代码文件。

3. 📂 本地知识库联动

当然，它也能完美访问你本地的 Obsidian 笔记，实现“本地笔记 + 云端资料”的混合检索。

实战演示：打造“无限”第二大脑

场景一：即时知识调取 (Just-in-Time Learning)

你正在写一篇关于“心流”的文章，记得网盘里存过一本《Flow: The Psychology of Optimal Experience》，但懒得去翻文件夹。

  • 你: “读取我网盘里的《Flow》这本书，总结米哈里关于‘挑战与技能平衡’的论述。”
  • AI: (搜索 -> 读取 PDF -> 提取文本) “根据书中的图表，当挑战水平高且技能水平也高时，人会进入心流状态…”

全程耗时 5 秒，你甚至没有打开网盘客户端。

场景二：代码合规性检查 (Compliance Check)

团队的《后端开发规范 v2.0.pdf》存放在公司的阿里云盘共享文件夹中。

  • 你 (在 Cursor 中): “检查当前 `user_service.ts` 的代码风格是否符合云端《后端开发规范》的要求。”
  • AI: (读取云端规范) “检测到你使用了 `var` 声明变量，根据规范第 3.1 条，应强制使用 `const` 或 `let`。”

如何开始？

  1. 安装插件: 在 Obsidian 中安装最新版 [Sync Vault](https://github.com/ozntel/obsidian-sync-vault)。
  2. 绑定网盘: 在插件设置中配置你的阿里云盘（或者百度网盘、OneDrive等）。
  3. 开启 MCP: 进入 `Settings` -> `Advanced` -> `AI Integration`，打开 MCP Server 开关。
  4. 连接 AI:
    • 在 Claude Code 或 Cursor 的配置文件中，添加 Sync Vault 的 MCP 服务地址（默认 `http://127.0.0.1:3000/sse`）。
{
"mcpServers": {
    "obsidian-vault": {
          "command": "node",
          "url": "http://127.0.0.1:3000/sse"
      }
  }
}

结语

Sync Vault 不仅仅是一个同步工具，它正在进化为你数字资产的 API 接口。通过 MCP，我们将沉睡在网盘里的数据变成了 AI 的燃料。

欢迎体验，让你的知识库“活”起来！

Tags: