ya-wiki-mcp

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

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

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

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

  • Может создавать, изменять и удалять страницы и вложения в корпоративной Wiki
  • Хранит OAuth-токен и кеш дерева страниц локально на диске пользователя
Все причины и проверки
Российский стек

imdeniil/ya-wiki-mcp

Установка

Сервисы

В терминале, через SkillFoxx CLI

npx skillfoxx add mcp/ya-wiki-mcp

Определит агенты на машине, покажет уровень доступа и зафиксирует версию.

Другие способы установки

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

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

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

  • Может создавать, изменять и удалять страницы и вложения в корпоративной Wiki
  • Хранит OAuth-токен и кеш дерева страниц локально на диске пользователя

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

Что делает

Сервер оборачивает Python-клиент ya-wiki-api и открывает агенту операции с Yandex Wiki: чтение и правку страниц, работу с динамическими таблицами (гридами), загрузку и скачивание вложений, поиск подстраниц. Отдельно ведется локальный кеш дерева страниц в ~/.cache/ya-wiki-mcp/tree.yaml, который обновляется сам при создании, изменении, удалении и клонировании страниц и ускоряет навигацию по разделам. Есть конвертер обычного Markdown в формат YFM (таблицы, врезки, спойлеры, подчеркивание) и менеджер шаблонов страниц, которые можно вызывать прямо из диалога.

Для кого. Для тех, кто ведет документацию или базу знаний в Yandex Wiki и хочет создавать и редактировать страницы через агента.

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

  • Нужно быстро найти, создать или обновить страницу в корпоративной Wiki
  • Нужно работать с динамическими таблицами (гридами) на страницах
  • Нужен перевод обычного Markdown в формат Yandex Flavored Markdown

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

  • Нужна только интеграция с Яндекс Трекером, без Wiki
  • Нет возможности получить OAuth-токен и завести отдельное приложение в oauth.yandex.ru

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

Найди страницу про онбординг в разделе team и допиши в конец пункт про доступ к Wiki

MCP

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

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

YA_WIKI_TOKEN обязательная, секрет
OAuth-токен Яндекса со скоупом wiki:read или wiki:write
YA_WIKI_ORG_ID обязательная
ID организации в Yandex 360 или Yandex Cloud
YA_WIKI_ORG_TYPE
cloud (по умолчанию) или business

Ограничения

Нужен OAuth-токен Яндекса со скоупом wiki:read или wiki:write и ID организации. Кеш дерева страниц хранится локально и может устареть, если структуру Wiki меняли не через этот сервер, тогда нужен ручной refresh_tree_cache. Разработка community, без привязки к вендору.

Как отключить. Удалите сервер ya-wiki из конфигурации MCP-клиента и при желании сотрите локальный кеш ~/.cache/ya-wiki-mcp/.

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

Как работает кеш дерева страниц?

Сервер хранит карту разделов в ~/.cache/ya-wiki-mcp/tree.yaml и обновляет ее сам при создании, изменении, удалении и клонировании страниц через инструменты сервера. Полную пересборку делает refresh_tree_cache.

Что делает конвертер Markdown?

convert_md_to_yfm переводит таблицы, врезки, спойлеры и подчеркивание из обычного Markdown в формат YFM, который использует Yandex Wiki.

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

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

Как работает кеш дерева страниц и как поставить сервер?

Кеш хранит дерево разделов, чтобы агент не запрашивал его каждый раз, детали в README. Установка: claude mcp add ya-wiki -e YA_WIKI_TOKEN=ваш-токен -e YA_WIKI_ORG_ID=ид-организации. Работает в Claude Code и Claude Desktop.

Обсуждение

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

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

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

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

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

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

MCP-сервер и CLI для Yandex Wiki на Python: создание, чтение, обновление и удаление страниц по одному slug

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

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

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

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

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

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

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

Коротко о README

README описывает 36 инструментов сервера по группам: страницы, ресурсы, динамические таблицы, кеш дерева, конвертер Markdown в YFM и менеджер шаблонов. Показана установка через uvx, конфигурация для Claude Desktop и таблица переменных окружения с шагами получения OAuth-токена. Отдельный раздел объясняет автосинхронизацию локального кеша дерева страниц и таблицу соответствий Markdown и YFM разметки. Лицензия MIT.

Бейдж для README

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