Yandex Disk MCP

Yandex。磁盘MCP服务器

Yandex的MCP服务器。磁盘REST API与Claude和其他MCP客户端的集成。

特性

此MCP服务器提供与Yandex交互的工具。磁盘：

• 📊 获取磁盘信息（总空间/已用空间）
• 📁 列出文件和文件夹
• 📄 获取文件/文件夹元数据
• ➕ 新建文件夹
• ⬆️ 上传文件（获取上传URL）
• ⬇️ 下载文件（获取下载URL）
• 🗑️ 删除文件/文件夹
• 📋 复制文件/文件夹
• 🔄 移动/重命名文件/文件夹
• 🕐 获取最近上传的文件

先决条件

• Node.js 18或更高版本
• Yandex。磁盘OAuth令牌

获取OAuth令牌

1. 首选 Yandex OAuth
2. 创建新的OAuth应用程序
3. 选择所需权限：

- cloud_api:disk.read -读取文件 - cloud_api:disk.write -写入文件 - cloud_api:disk.info -磁盘信息

1. 获取您的客户ID
2. 在浏览器中打开此URL（替换 `` 使用您的实际客户ID）：

   https://oauth.yandex.ru/authorize?response_type=token&client_id=

1. 从授权页面复制令牌
2. 安全保存令牌

安装

选项1：从npm安装（推荐）

npm install -g yandex-disk-mcp

选项2：从GitHub安装

git clone https://github.com/gorokhovdenis/yandex-disk-mcp.git
cd yandex-disk-mcp
npm install
npm run build

配置

添加到您的Claude Code配置文件中(~/.claude.json):

{
  "mcpServers": {
    "yandex-disk": {
      "type": "stdio",
      "command": "node",
      "args": ["/path/to/yandex-disk-mcp/dist/index.js"],
      "env": {
        "YANDEX_DISK_TOKEN": "your_oauth_token_here"
      }
    }
  }
}

注： 替换 /path/to/yandex-disk-mcp 使用克隆存储库的实际路径。

可用工具

yandex_disk_info

获取有关Yandex的信息。磁盘（总空间、已用空间等）

参数： 无

例子：

Claude, get my Yandex.Disk info

yandex_disk_list_files

列出Yandex上的所有文件。磁盘（平面列表）

参数：

• limit （number，可选）：要返回的最大文件数（默认值：20）
• offset （数字，可选）：分页偏移量（默认值：0）

例子：

Claude, list 50 files from my Yandex.Disk

yandex_disk_get-metadata

获取特定文件或文件夹的元数据

参数：

• path （字符串，必填）：文件或文件夹的路径（例如，“/Documents/file.txt”）

例子：

Claude, get metadata for /Documents/report.pdf on Yandex.Disk

yandex_disk_create_folder

创建新文件夹

参数：

• path （字符串，必填）：新文件夹的路径（例如，“/Documents/NewFolder”）

例子：

Claude, create folder /Backups/2026 on Yandex.Disk

yandex_disk_get_upload_url

获取上传文件的URL

参数：

• path （string，必填）：上传文件的路径
• overwrite （布尔值，可选）：如果文件存在，是否覆盖（默认值：true）

例子：

Claude, get upload URL for /Documents/report.pdf on Yandex.Disk

yandex_disk_get-download_url

获取下载文件的URL

参数：

• path （string，必填）：要下载的文件的路径

例子：

Claude, get download URL for /Documents/report.pdf from Yandex.Disk

yandex_disk_delete

删除文件或文件夹

参数：

• path （string，必填）：要删除的文件或文件夹的路径
• permanently （布尔值，可选）：永久删除（true）或移动到垃圾桶（false，默认）

例子：

Claude, delete /temp/old_file.txt from Yandex.Disk

yandex_disk_copy

复制文件或文件夹

参数：

• from （字符串，必填）：源路径
• to （字符串，必填）：目标路径
• overwrite （布尔值，可选）：如果目标存在则覆盖（默认值：true）

例子：

Claude, copy /Documents/file.txt to /Backups/file.txt on Yandex.Disk

yandex_disk_move

移动或重命名文件或文件夹

参数：

• from （字符串，必填）：源路径
• to （字符串，必填）：目标路径
• overwrite （布尔值，可选）：如果目标存在则覆盖（默认值：true）

例子：

Claude, move /temp/file.txt to /Documents/file.txt on Yandex.Disk

yandex_disk_last_已上传

获取最近上传的文件列表

参数：

• limit （number，可选）：要返回的最大文件数（默认值：10）

例子：

Claude, show me 20 recently uploaded files on Yandex.Disk

使用示例

配置后，您可以与Claude一起使用自然语言：

1. 检查磁盘空间：

   "Show me how much space I have on Yandex.Disk"

1. 上传文件：

   "Upload this file to /Documents/report.pdf on Yandex.Disk"

（Claude将获得上传URL，然后您可以使用curl或其他工具进行实际上传）

1. 组织文件：

   "Create a folder /Projects/2026 and move all files from /temp there on Yandex.Disk"

1. 备份文件：

   "Copy all .md files from current directory to /Backups on Yandex.Disk"

发展

# Install dependencies
npm install

# Build
npm run build

# Watch mode (for development)
npm run watch

# Run in development mode
npm run dev

API 参考

此服务器使用 Yandex。磁盘REST API.

API终结点： https://cloud-api.yandex.net/v1/disk

许可证

麻省理工学院

贡献

欢迎投稿！请随时提交拉取请求。

作者

丹尼斯·戈罗霍夫

链接

• Yandex。磁盘API文档
• MCP协议