MCP 服务器配置

Sync Vault 支持 Model Context Protocol (MCP)，允许 AI 工具直接与您的云端文件交互。

MCP 工具能力

工具	说明	备注
`get_cloud_account_info`	获取云盘账户信息与存储容量
`list_cloud_files`	列出指定云盘路径下的文件和文件夹
`read_cloud_file`	读取云盘文件内容（支持流式）
`create_cloud_file`	在云盘中创建文件或文件夹
`delete_cloud_file`	删除云盘文件或文件夹
`move_cloud_file`	移动云盘文件或文件夹
`rename_cloud_file`	重命名云盘文件或文件夹
`download_cloud_file`	下载云盘文件到本地
`upload_cloud_file`	上传本地文件到云盘
`semantic_search`	基于语义的全局搜索	仅百度网盘
`sharelink_set`	设置/创建分享链接	仅百度网盘
`upload_by_url`	通过离线 URL 任务上传	仅百度网盘

Claude Code CLI

在 .claude/mcp.json 中添加如下配置（该文件通常位于用户根目录）：

{
  "mcpServers": {
    "sync-vault-mcp": {
      "type": "sse",
      "url": "http://127.0.0.1:3000/sse"
    }
  }
}

Claude Desktop

由于 Claude Desktop 仅支持通过 STDIO 方式接入 MCP Server，需要使用桥接器将 Sync Vault 的 SSE 接口转换为 STDIO 接口。我们推荐使用 sse-bridge。

安装桥接器：npm install -g @mcpwizard/sse-bridge
在 Claude Desktop 【设置】-【开发者】 中点击编辑配置按钮，添加以下代码：

{
  "mcpServers": {
    "sync-vault-mcp": {
      "command": "npx",
      "args": [
        "@mcpwizard/sse-bridge",
        "http://127.0.0.1:3000/sse"
      ]
    }
  }
}

Cursor / Trae

在 Cursor/Trae 的 MCP 设置中，选择手动添加 MCP Server：

名称: Sync Vault MCP
类型: SSE
URL: http://127.0.0.1:3000/sse（默认地址）

{
  "mcpServers": {
    "sync-vault-mcp": {
      "type": "sse",
      "url": "http://127.0.0.1:3000/sse"
    }
  }
}