MCP для Яндекс Диска с фоновой загрузкой

yadisk-mcp

MCP-сервер для Яндекс Диска с 22 инструментами: файлы, публикация и корзина, фоновая загрузка больших файлов и режим только для чтения

  • 1 ★ репозитория
  • Последний коммит
  • MIT
MCP-сервер

Расширенный доступ

Почему такой уровень

  • По умолчанию может удалять, перемещать и публиковать файлы на Яндекс Диске
  • Может загружать произвольные локальные файлы, если не ограничить папки переменной окружения
  • Советуем начинать с флага --read-only, пока не нужна запись
Все причины и проверки
Российский стек

patr56/yadisk-mcp

Установка

Сервисы

Ручная установка

pip install yadisk-mcp

Установка пакета из PyPI.

Доступ и проверки

Как мы проверяем

Расширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.

  • По умолчанию может удалять, перемещать и публиковать файлы на Яндекс Диске
  • Может загружать произвольные локальные файлы, если не ограничить папки переменной окружения
  • Советуем начинать с флага --read-only, пока не нужна запись

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Сервер асинхронно покрывает API Яндекс Диска 22 инструментами: квота и информация о диске, список и поиск файлов, создание, копирование, перемещение, переименование и удаление, загрузка локального файла (до примерно 100 МБ синхронно, крупные файлы в фоне с job_id и трекингом прогресса), загрузка по URL, публикация файлов со ссылкой и снятие публикации, работа с корзиной. Флагом --read-only, переменной окружения или программно можно заблокировать все пишущие операции и оставить только просмотр. Отдельная переменная ограничивает, из каких локальных папок разрешена загрузка, и блокирует симлинки за их пределы.

Для кого. Для тех, кто хочет полноценно управлять Яндекс Диском через агента: от загрузки больших файлов до публикации ссылок.

Подходит, если

  • Нужна загрузка больших файлов в фоне с отслеживанием прогресса
  • Нужно опубликовать файл и получить публичную ссылку прямо из диалога с агентом
  • Нужен безопасный режим только для чтения для демонстраций или просмотра чужого диска

Не подходит, если

  • Нужен минимальный сервер без пишущих операций вообще: тут запись включена по умолчанию, режим только для чтения нужно включать отдельно
  • Не хочется выдавать токен с правами записи на весь диск

Пример запроса к агенту

Найди все PDF-файлы на Яндекс Диске за последний месяц и опубликуй самый свежий

MCP

Транспорт
stdio
Авторизация
API-ключ

Переменные окружения

YANDEX_DISK_TOKEN обязательная, секрет
OAuth-токен Яндекса с правами cloud_api:disk.read, disk.write, disk.app_folder, disk.info
YADISK_MCP_READ_ONLY
Включает режим только для чтения и блокирует все пишущие инструменты
YADISK_MCP_UPLOAD_ALLOWED_DIRS
Список локальных папок, из которых разрешена загрузка файлов на диск

Ограничения

Нужен OAuth-токен Яндекса с правами cloud_api:disk.read, disk.write, disk.app_folder и disk.info, полученный через собственное приложение на oauth.yandex.ru. Токен действует год и требует ручного обновления. По умолчанию upload_local_file может загрузить любой локальный файл, если не задать YADISK_MCP_UPLOAD_ALLOWED_DIRS. Полная очистка корзины необратима.

Как отключить. Удалите сервер командой claude mcp remove yadisk или из конфигурации клиента вручную и отзовите OAuth-токен на oauth.yandex.ru.

Частые вопросы

Можно ли запретить агенту изменять файлы?

Да, флаг --read-only, переменная YADISK_MCP_READ_ONLY=true или программный вызов configure(read_only=True) блокируют все операции записи, публикации и очистки корзины.

Как ограничить, какие локальные файлы можно загружать?

Переменной YADISK_MCP_UPLOAD_ALLOWED_DIRS со списком разрешенных папок, симлинки за их пределы блокируются автоматически.

Чем yadisk-mcp отличается от других MCP для Яндекс Диска?

Сервер асинхронно покрывает API Яндекс Диска 22 инструментами: квота и информация о диске, список и поиск файлов, создание, копирование, перемещение, переименование и удаление, публикация, корзина, фоновая загрузка больших файлов и режим только для чтения.

Можно ли запретить агенту изменять файлы и ограничить загрузку локальных файлов?

Да, включите режим только для чтения, тогда изменения станут недоступны. В режиме только для чтения блокируются все инструменты загрузки, а ограничение загрузки по каталогам в README не описано. Установка: pip install yadisk-mcp. Работает в Claude Code и Claude Desktop.

Обсуждение

Вопросов и отзывов пока нет.

Российский стек

Небольшой Python MCP-сервер для Яндекс Диска: просмотр, загрузка, скачивание и создание файлов, но без изменения существующих

MCP-серверРасширенный доступ
Российский стек

MCP-сервер для Яндекс Диска, нацеленный на поиск больших файлов и уборку по API, минуя локальную синхронизацию

MCP-серверРасширенный доступ

Yandex Disk MCP (Antiloop)

Yandex Disk MCP Server

Российский стек

MCP-сервер Яндекс Диска: файлы и папки, публичные ссылки, загрузка по URL, корзина и поиск, с запуском в Docker

MCP-серверШирокий доступ5Звезды репозитория
Российский стек

MCP-сервер для Яндекс Диска: папки, метаданные, копирование, перемещение, удаление и ссылки на загрузку и скачивание

MCP-серверШирокий доступ4Звезды репозитория
Российский стек

Небольшой MCP-сервер для чтения Яндекс Диска: списки папок, поиск файлов, ссылки на скачивание и публичные ссылки

MCP-серверРасширенный доступ

Коротко о README

README на русском с английской версией отдельным файлом описывает сервер как полностью асинхронный, с фоновой загрузкой больших файлов и трекингом прогресса. Дана таблица из 22 инструментов по категориям: информация и поиск, файловые операции, загрузка и скачивание, публикация, корзина. Подробно расписано получение OAuth-токена через собственное приложение на oauth.yandex.ru с нужными правами, установка через pip install yadisk-mcp или из исходников, подключение в Claude Code и Claude Desktop, режим --read-only со списком заблокированных и доступных инструментов и переменная ограничения папок загрузки. Есть CI и публикация в PyPI.

Бейдж для README

Сообщить о проблеме