SuperAPI AI 工具集
合作ENAI 行业资讯收藏
全部工具AI开发平台yandex-workspace-mcp

yandex-workspace-mcp

yandex-workspace-mcp 是一个面向 AI 智能体的 Model Context Protocol（MCP）服务器，用于将 Yandex Disk 与 Yandex Wiki 集成到 AI 助手中。它提供统一接口，让 AI 助手能够搜索、读取并智能更新 Yandex Disk 和 Yandex Wiki 中的数据，无需依赖网页抓取或未公开 API。该服务器以安全为优先设计：默认只读，提供读、写、删除的细粒度权限控制，通过 ALLOWED_ROOTS 进行路径白名单限制，并对所有写入/破坏性操作进行结构化审计日志记录。它包含 Yandex Disk 集成（22 个对等工具加 disk_read 和 inline disk_upload，覆盖容量、列表/最近/搜索、元数据、签名链接、上传、变更、公共资源、回收站及有界本地任务）和 Yandex Wiki 集成（27 个类型化工具加 wiki_get_tree 兼容别名，覆盖搜索、页面读写、评论、资源、恢复、附件和动态表格），并提供统一工作区搜索工具，可同时查询 Disk 和 Wiki。

访问官网

工具介绍

用途

yandex-workspace-mcp 是一个 Model Context Protocol（MCP）服务器，用于将 AI 智能体与 Yandex Disk 和 Yandex Wiki 集成。它为 AI 助手提供统一接口，使其能够搜索、读取并智能更新 Yandex Disk 和 Yandex Wiki 中的数据，而无需使用网页抓取或未公开的 API。

主要能力

Yandex Disk 集成

提供 22 个对等工具，外加 disk_read 和 inline disk_upload，覆盖容量、列表/最近/搜索、元数据、签名链接、上传、变更、公共资源、回收站以及有界本地任务。

Yandex Wiki 集成

提供 27 个类型化工具，外加 wiki_get_tree 兼容别名，覆盖搜索、页面读写、评论、资源、恢复、附件和动态表格。

统一工作区搜索

单一搜索工具允许智能体同时查询 Disk 和 Wiki。

安全优先架构

  • 默认只读。
  • 针对读、写、删除操作的细粒度权限。
  • 路径白名单（ALLOWED_ROOTS）严格限制 AI 操作范围。
  • 对所有写入/破坏性操作进行详细、结构化的审计日志记录。

使用方式

配置

将 .env.example 复制为 .env 并填写相应值。

认证

HTTP 部署有三种明确模式：回环开发、静态单租户 bearer，以及由加密内存/Redis 状态支持的多用户 Yandex OAuth。CLI 传输覆盖在服务器构建前经过验证，认证的 HTTP 请求在没有 SDK 认证上下文时失败关闭，MCP 访问令牌必须与 Yandex 凭据不同。

获取 OAuth 令牌的步骤：

  1. 前往 Yandex OAuth 门户。
  2. 创建新的客户端应用。
  3. 授予“Yandex.Disk REST API”（cloud_api:disk.read、cloud_api:disk.write、cloud_api:disk.info）和“Yandex Wiki”（wiki:read、wiki:write）权限。
  4. 生成 OAuth 令牌并保存到 .env 文件。

对于多用户模式，注册确切的 HTTPS MCP_OAUTH_CALLBACK_URL，而不是生成全局令牌，然后设置 YANDEX_OAUTH_CLIENT_ID、YANDEX_OAUTH_CLIENT_SECRET，将两种认证模式设为 multi-user，配置 Redis 以及独立的游标/加密密钥环。

运行

通过提供的 CLI 运行。运行诊断并验证配置。

客户端配置

将相应配置添加到 MCP 客户端（如 Claude Desktop / Cursor）的配置文件中。

权限门控细节

Wiki 工具与权限门控

WIKI_READ 发布八个参考读取工具以及 wiki_get_tree。WIKI_WRITE 增加页面追加/克隆/评论操作以及网格创建/更新/复制/行/单元格/列变更。WIKI_DELETE 增加页面/网格/行/列删除和页面恢复。本地附件上传额外要求 stdio 和非空的 WIKI_UPLOAD_ALLOWED_DIRS；它永远不会为远程传输注册。

每个定位器和网格所有者都会在数据返回或更改前根据 WIKI_ALLOWED_ROOTS 进行解析和检查。网格变更要求调用者提供修订版本，在单个进程内按网格串行化，冲突会暴露而不会自动重放。页面克隆和网格复制仅接受经过验证的精确来源操作 URL；这些 URL 不会返回给 MCP 客户端。

页面删除返回随机的 MCP 恢复句柄，而不是 Yandex 的令牌。句柄在 15 分钟后过期，绑定主体且单次使用，上游令牌静态加密。多用户副本将句柄存储在与 OAuth 状态相同的 Redis 后端中，因此另一个副本可以在重启后使用它们；本地/静态部署使用进程本地句柄。远程删除/恢复需要 MCP_TOKEN_ENCRYPTION_KEYS。

Disk 工具与权限门控

DISK_READ 暴露 disk_info、list/recent/search/metadata/download、disk_list_trash 以及有界文本 disk_read 兼容工具。disk_get_public_resource 仅在 DISK_ALLOWED_PUBLIC_KEYS 非空时额外注册。每个直接路径在 HTTP 调用前检查；最近、搜索、嵌入子项和回收站结果在输出前进行后过滤。

DISK_WRITE 暴露内联上传、文件夹/复制/移动/重命名、发布/取消发布，以及当 DISK_UPLOAD_URL_ALLOWED_HOSTS 非空时的 URL 导入。本地文件上传及其四个本地任务工具要求 stdio 加 DISK_UPLOAD_ALLOWED_DIRS；它们在远程不存在。任务在内存中有界、会过期、从不返回源路径或凭据，并在关闭时取消。

DISK_DELETE 暴露资源删除和回收站恢复。拒绝永久删除已配置的根。disk_empty_trash 不存在，除非允许的根包含 / 且 DISK_ALLOW_GLOBAL_DESTRUCTIVE=true；每次调用还需要字面量 confirm=true。

搜索契约与 API 漂移

规范搜索工具并发查询 Wiki 和 Disk，返回 Wiki 优先的轮询结果，报告部分源失败，并使用签名的复合游标。独立的 disk_search 游标和规范工作区游标不同，并绑定到规范化查询和调用者。无效或过期的游标失败关闭。

Wiki 全文搜索使用 POST /v1/search。该端点被跟踪为 YANDEX_API_DOCS_WIRE_DRIFT，因为文档化和观察到的 Yandex 字段可能独立变化。如果搜索端点不可用或其成功响应不再匹配类型化契约，服务器使用有界后代回退。回退结果明确标记 degraded=true 和 search_mode="descendants"；认证、权限、速率限制、传输、验证和正常空结果情况从不触发回退。

每个 Wiki/Disk 结果即使发送了上游过滤器，也会根据配置的根进行后过滤。已启用服务但没有允许的根会导致启动失败。签名下载/上传使用单独的无令牌传输：检查 HTTPS/Yandex 后缀、所有 DNS 答案、连接的对等方、重定向和字节上限，而不转发 OAuth 头。

适用场景

适用于需要将 AI 智能体安全接入 Yandex Disk 和 Yandex Wiki 的场景，例如让 AI 助手在受控权限下搜索、读取和更新企业或个人云盘与知识库内容，同时满足审计与合规要求。

限制

  • 默认只读，写入和删除需要显式配置权限。
  • 本地文件上传和本地任务工具仅支持 stdio 传输，远程传输不可用。
  • 远程删除/恢复需要 MCP_TOKEN_ENCRYPTION_KEYS。
  • 已启用服务必须配置允许的根，否则启动失败。
  • 搜索端点存在 API 漂移风险，可能触发降级回退。
  • 离线示例使用模拟上游客户端，不验证 Yandex 可用性、实时 API 一致性、负载能力或特定部署。

同类工具

查看分类