yandex-wiki-mcp

MCP-сервер для Yandex Wiki с 30 инструментами: страницы, вложения, комментарии, гриды, перенос страниц через clone и удаление

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

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

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

  • Может создавать, переносить (через clone и delete) и удалять страницы и вложения
  • Операция переноса необратимо удаляет оригинал после клонирования
Все причины и проверки
Российский стек

in5pirer/yandex-wiki-mcp

Установка

Сервисы

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

git clone https://github.com/in5pirer/yandex-wiki-mcp.git && cd yandex-wiki-mcp && pip install -r requirements.txt && cp .env.example .env

После установки заполните .env своими данными.

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

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

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

  • Может создавать, переносить (через clone и delete) и удалять страницы и вложения
  • Операция переноса необратимо удаляет оригинал после клонирования

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

Что делает

Сервер закрывает почти весь 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 вместе со всеми подстраницами, сначала покажи план без записи

MCP

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

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

YANDEX_WIKI_TOKEN обязательная, секрет
OAuth-токен приложения с правами на Wiki
YANDEX_WIKI_ORG_ID обязательная
ID организации из Yandex Cloud Console
YANDEX_WIKI_ORG_TYPE
cloud или 360

Ограничения

wiki_search_pages не делает полнотекстовый поиск: API его не поддерживает, инструмент ищет только по точному slug. Перенос страницы физически меняет page_id, комментарии и история правок не переносятся. После изменения кода нужно перезапускать Cursor. Официального пакета нет, установка вручную через git clone и pip.

Как отключить. Удалите блок yandex-wiki из ~/.cursor/mcp.json или конфигурации своего клиента.

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

Почему у Wiki нет настоящего move?

README ссылается на официальные release notes Яндекса: перенос страницы это функция только веб-интерфейса, у API есть лишь clone с последующим удалением оригинала.

Ищет ли wiki_search_pages по тексту?

Нет, Yandex Wiki API не дает полнотекстового поиска, инструмент ищет только по точному slug. Для просмотра раздела нужен wiki_get_descendants_by_slug.

Обсуждение

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

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

MCP-сервер для Yandex Wiki на базе пакета ya-wiki-api: 36 инструментов для страниц, гридов, вложений и кеша дерева разделов

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

MCP-сервер на 28 инструментов для Yandex Wiki API v1: страницы, вложения, комментарии, таблицы и восстановление удаленного

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

MCP-сервер для API Яндекс Вики со страницами, вложениями, восстановлением через токен и редким полным набором инструментов для динамических таблиц

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

MCP-сервер для Яндекс Вики: чтение страниц по slug или ссылке, создание, обновление и дописывание, есть режим только чтения

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

MCP-сервер для Яндекс Wiki на IAM-токене Yandex Cloud: 12 инструментов для страниц, подстраниц, комментариев и вложений

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

Сравнение с похожими

Карточки с тем же главным запросом: чем они отличаются.

ИнструментОфициальныйАвторизацияЗвезды репозиторияГлавное отличие
yandex-wiki-mcp (эта карточка)нетAPI-ключ0
Yandex Wiki MCPнетOAuth9чтение и правка страниц
MCP для Яндекс Вики с таблицами и 3-way mergeнетOAuth0таблицы
MCP для Яндекс Вики с авторизацией PKCEнетOAuth0через браузер

Коротко о README

README на русском перечисляет 30 инструментов по разделам: чтение, редактирование, файлы, комментарии, подписчики, гриды. Показана установка через git clone и pip, настройка .env и подключение к Cursor. Отдельные разделы changelog v0.4.0 и v0.3.0 честно описывают найденные и исправленные баги, включая ложноположительный успех переноса страницы, и таблица известных ограничений API.

Бейдж для README

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