yandex-wiki-mcp
MCP-сервер для Yandex Wiki с 30 инструментами: страницы, вложения, комментарии, гриды, перенос страниц через clone и удаление
Средний риск
Средний уровень ставим, когда инструмент запускает код, ходит в сеть или читает файлы проекта. Перед установкой посмотрите, что именно он делает.
Почему такой уровень
- Может создавать, переносить (через clone и delete) и удалять страницы и вложения
- Операция переноса необратимо удаляет оригинал после клонирования
Установка
Ручная установка
git clone https://github.com/in5pirer/yandex-wiki-mcp.git && cd yandex-wiki-mcp && pip install -r requirements.txt && cp .env.example .envПосле установки заполните .env своими данными.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер закрывает почти весь Yandex Wiki API: чтение и правку страниц, историю правок, вложения через Upload Sessions API, комментарии с тредами, подписчиков и динамические таблицы. Отдельно решена честная проблема: у Wiki API нет настоящего move и rename страницы, поэтому wiki_move_page реализован как clone с проверкой успеха и последующим удалением оригинала, а wiki_move_subtree переносит страницу с потомками, откатывая уже созданные клоны при частичном сбое. В changelog описана история исправления ложноположительных результатов: старая версия рапортовала успех переноса, хотя API не принимает поле slug при обновлении.
Для кого. Для разработчиков, которым нужен самый полный набор операций с Yandex Wiki, включая перенос страниц и работу с вложениями.
Подходит, если
- Нужны 30 инструментов, включая историю правок, комментарии и вложения
- Нужен перенос страницы или целого поддерева, даже если у API нет прямого move
- Работаете через Cursor и готовы вручную настроить python-сервер
Не подходит, если
- Нужен готовый пакет без git clone и pip install
- Важно, чтобы после переноса страницы сохранялись id, комментарии и история правок: API этого не дает
Пример запроса к агенту
Перенеси страницу old-team/notes в new-team/notes вместе со всеми подстраницами, сначала покажи план без записиОграничения
wiki_search_pages не делает полнотекстовый поиск: API его не поддерживает, инструмент ищет только по точному slug. Перенос страницы физически меняет page_id, комментарии и история правок не переносятся. После изменения кода нужно перезапускать Cursor. Официального пакета нет, установка вручную через git clone и pip.
Как отключить. Удалите блок yandex-wiki из ~/.cursor/mcp.json или конфигурации своего клиента.
MCP
- Транспорт
- stdio
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| YANDEX_WIKI_TOKEN обязательная, секрет | OAuth-токен приложения с правами на Wiki |
| YANDEX_WIKI_ORG_ID обязательная | ID организации из Yandex Cloud Console |
| YANDEX_WIKI_ORG_TYPE | cloud или 360 |
Проверка безопасности
- Может создавать, переносить (через clone и delete) и удалять страницы и вложения
- Операция переноса необратимо удаляет оригинал после клонирования
Коротко о README
README на русском перечисляет 30 инструментов по разделам: чтение, редактирование, файлы, комментарии, подписчики, гриды. Показана установка через git clone и pip, настройка .env и подключение к Cursor. Отдельные разделы changelog v0.4.0 и v0.3.0 честно описывают найденные и исправленные баги, включая ложноположительный успех переноса страницы, и таблица известных ограничений API.
Частые вопросы
Почему у Wiki нет настоящего move?
README ссылается на официальные release notes Яндекса: перенос страницы это функция только веб-интерфейса, у API есть лишь clone с последующим удалением оригинала.
Ищет ли wiki_search_pages по тексту?
Нет, Yandex Wiki API не дает полнотекстового поиска, инструмент ищет только по точному slug. Для просмотра раздела нужен wiki_get_descendants_by_slug.
Похожие
Утилита Microsoft и MCP-сервер, которые переводят PDF, Word, Excel, PowerPoint, HTML и другие файлы в Markdown для модели
Скиллы Anthropic
Skills
Официальные примеры скиллов Anthropic: документы docx, pdf, pptx, xlsx, дизайн, MCP builder и спецификация Agent Skills
Скилл, который собирает редактируемые PPTX-презентации из PDF, DOCX, ссылок и Markdown с настоящими фигурами, диаграммами и анимациями
Скилл рисует редакторские диаграммы как самостоятельные файлы HTML и SVG: архитектура, блок-схемы, ER, воронки и еще около сорока типов