yandex-wiki-search-mcp
yandex-wiki-search-mcp — MCP-сервер сообщества (автор — dlbolshov). Яндекс Вики с полнотекстовым поиском: страницы, комментарии, вложения и динамические таблицы, есть режим только чтения. Ставится через Docker. Лицензия Apache-2.0.
Опубликовано 13.11.2026 · Обновлено 13.11.2026 · Проверено 13.11.2026
Кратко о сервере
- Разработчик
- dlbolshov
- Лицензия
- Apache-2.0
- Транспорт
- stdio, streamable_http
- Авторизация
- token_env
- ОС
- linux, macos, windows
- Языки
- python
Уровень риска: high
Действует с правами OAuth-токена: при выключенном режиме чтения переписывает и удаляет страницы и гриды. Держите `WIKI_READ_ONLY=true`, пока правки не нужны.
Настройка клиентов
{
"code": "claude mcp add yandex-wiki-search \\\n -e WIKI_TOKEN=YOUR_TOKEN -e WIKI_ORG_ID=YOUR_ORG_ID -e WIKI_READ_ONLY=true \\\n -- uvx yandex-wiki-search-mcp",
"lang": "bash",
"notes": "Дословно из README",
"verified": "docs"
}
Что умеет
Yandex Wiki Search MCP подключает Claude, Cursor, Windsurf и другие MCP-клиенты к Яндекс Вики. Сервер даёт 33 инструмента с типизированными схемами: полнотекстовый поиск, работа со страницами, комментариями, вложениями и динамическими таблицами (гридами). Это неофициальный проект, не связанный с Яндексом.
- Поиск и чтение (10 инструментов): поиск по всей вики через тот же механизм, что и строка поиска в веб-интерфейсе (
page_search, до 50 результатов на запрос), получение страницы по id, slug или полной ссылке (page_get), обход дерева страниц, комментарии, вложения, гриды и текущий пользователь. - Чтение вложений:
page_read_attachmentотдаёт содержимое файла прямо в разговор, изображения приходят как картинки для клиентов с поддержкой зрения. - Страницы (12 инструментов записи): создание, обновление, правка точечными заменами текста (
page_edit), добавление контента в начало, конец или к якорю, клонирование, комментарии, загрузка файлов, удаление с токеном восстановления. - Гриды (11 инструментов записи): строки, столбцы, ячейки, копирование и сортировка.
У каждого инструмента есть JSON-схема входа и пометки безопасности: только чтение, разрушающее действие, идемпотентность. Сервер работает по stdio для настольных клиентов и по streamable-http в Docker для команд, с необязательным многопользовательским OAuth.
Кому подойдёт
- Командам на Яндекс 360, у которых документация, регламенты и онбординг живут в Вики: агент находит нужную страницу и пересказывает её.
- Тимлидам и менеджерам: заметки по стендапам, дописывание страниц, строки в таблице дежурств.
- Разработчикам, которым нужен контекст из внутренней вики прямо в IDE.
Похожие серверы — в категории знания и память.
Установка
- Получите OAuth-токен Яндекса с доступом к Вики (по официальной инструкции Яндекса) и ID организации.
- Для запуска через
uvxнужен установленный uv. Вариант через Docker работает без Python, образghcr.io/dlbolshov/yandex-wiki-search-mcp:latest. - Начните с
WIKI_READ_ONLY=true: в этом режиме сервер вообще не регистрирует инструменты записи. Переключите наfalse, когда будете готовы доверить агенту правки.
Сервер построен на MCP Python SDK v2 и отвечает клиентам на всех ревизиях протокола начиная с 2024-11-05. Для окружений, где закреплён mcp<2, на PyPI остаётся версия 1.0.1.
Подключение к клиентам
Конфиги приведены дословно из README. Вместо YOUR_TOKEN и YOUR_ORG_ID подставьте свои значения. Общий порядок — в инструкции как подключить MCP.
{
"mcpServers": {
"yandex-wiki-search": {
"command": "uvx",
"args": ["yandex-wiki-search-mcp"],
"env": {
"WIKI_TOKEN": "YOUR_TOKEN",
"WIKI_ORG_ID": "YOUR_ORG_ID",
"WIKI_READ_ONLY": "true"
}
}
}
}Тот же JSON подходит для Windsurf и других клиентов с конфигом mcpServers.
Проверка
Спросите агента: «Найди наши материалы по онбордингу и перескажи основные шаги». Он вызовет page_search, затем page_get. Если поиск возвращает ошибку доступа, проверьте токен, права на Вики и ID организации.
Примеры задач
Что у нас есть про реагирование на инциденты? Открой самую подходящую страницу.Создай страницу team/weekly-notes и допиши в неё итоги сегодняшнего стендапа.Добавь строку в таблицу дежурств: alice, следующая неделя.Риски
Сервер действует с правами вашего OAuth-токена: видит всё, что доступно вам в Вики, а при выключенном режиме чтения может переписывать и удалять страницы, менять гриды и загружать файлы. Ошибочная правка общего регламента затронет всю команду.
Как снизить риски: держите WIKI_READ_ONLY=true, пока не нужны правки. Это ограничение на стороне сервера, агент не может его обойти. При удалении страницы сервер возвращает токен восстановления, сохраните его. Храните токен в переменных окружения и не публикуйте конфиг с ним. Лицензия — Apache-2.0.
Частые вопросы
Это официальный сервер Яндекса?
Нет. Проект неофициальный и не связан с Яндексом.
Как запретить агенту правки?
Задайте WIKI_READ_ONLY=true. Инструменты записи не будут зарегистрированы.
Можно ли развернуть сервер для всей команды?
Да. README описывает режим streamable-http в Docker с необязательным многопользовательским OAuth.
Основы протокола — на странице что такое MCP-сервер.
Инструменты
- page_search
- page_get
- page_read_attachment
- grid_get
- page_create
- page_edit
- page_append_content
- page_add_comment
Похожие MCP-серверы
CodeBurn
Учёт расходов, токенов и квот ИИ-инструментов программирования, включая Claude Code и Cursor.
google_workspace_mcp
Google Workspace: Календарь, Диск, Gmail, Документы, Формы, Чат, Презентации и Таблицы.
RevoGrid DataGrid MCP
Справка по RevoGrid DataGrid для агентов.
kordoc
Разбор корейских документов HWP, HWPX и офисных форматов в Markdown.