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`, пока правки не нужны.

Настройка клиентов

claude-code
{
    "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.

Похожие серверы — в категории знания и память.

Установка

  1. Получите OAuth-токен Яндекса с доступом к Вики (по официальной инструкции Яндекса) и ID организации.
  2. Для запуска через uvx нужен установленный uv. Вариант через Docker работает без Python, образ ghcr.io/dlbolshov/yandex-wiki-search-mcp:latest.
  3. Начните с 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.

claude_desktop_config.json
{
  "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.

Риск: medium Лицензия: MIT ★ 11 762

google_workspace_mcp

Google Workspace: Календарь, Диск, Gmail, Документы, Формы, Чат, Презентации и Таблицы.

Риск: medium Лицензия: MIT ★ 3 495

RevoGrid DataGrid MCP

Справка по RevoGrid DataGrid для агентов.

Риск: medium Лицензия: MIT ★ 3 455

kordoc

Разбор корейских документов HWP, HWPX и офисных форматов в Markdown.

Риск: medium Лицензия: MIT ★ 2 938

Источники