yuque-mcp-server

yuque-mcp-server — MCP-сервер сообщества (автор — yuque). Доступ к базе знаний Yuque. Ставится через npx. Лицензия MIT.

Опубликовано 13.11.2026 · Обновлено 14.11.2026 · Проверено 13.11.2026

Кратко о сервере

Разработчик
yuque
Лицензия
MIT
Транспорт
stdio
Авторизация
token_env
ОС
Не указана
Языки
typescript

Уровень риска: high

Инструменты создания и изменения правят реальные документы и базы знаний Yuque в пределах прав токена.

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

cursor
{
    "code": "npx yuque-mcp install --token=YOUR_TOKEN --client=cursor",
    "lang": "bash",
    "notes": "Установщик из README сам добавляет запись в конфиг Cursor",
    "verified": "docs"
}

Что умеет

Yuque MCP Server — официальный сервер для базы знаний Yuque (语雀). Он позволяет ИИ-ассистенту читать и редактировать ваши базы знаний, документы, заметки и схемы. В сервере 19 инструментов, каждый соответствует ровно одному методу API Yuque:

  • пользователь и поиск: данные владельца токена, поиск документов и баз знаний с постраничной выдачей;
  • базы знаний: список, просмотр, создание, изменение названия, адреса, описания и видимости;
  • документы: список, полное содержимое в форматах markdown, lake или html, создание и изменение;
  • оглавление: чтение, добавление и перемещение узла;
  • заметки: список с фильтром по статусу, чтение, создание, изменение;
  • схемы (интеллект-карты, блок-схемы, диаграммы): чтение, создание и изменение внутри документа.

Пока не поддерживаются комментарии, загрузка вложений, управление правами и участниками, правка отдельных разделов документа.

Кому подойдёт

  • Командам, которые ведут документацию в Yuque: поиск и краткие сводки по базе знаний.
  • Тем, кто хочет превращать заметки со встреч в документы нужной базы знаний.
  • Авторам технических документов: добавление блок-схем процессов прямо из диалога.

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

Установка

Нужен Node.js 18 или новее. Создайте токен в настройках разработчика Yuque. Если используете командный токен, привязанный к пространству, запишите адрес пространства — он передаётся параметром --host или переменной YUQUE_HOST. Без него используется https://www.yuque.com/api/v2.

Установщик сам находит файл настроек клиента для вашей ОС и добавляет запись yuque, не трогая другие серверы. Поддерживаемые значения --client: claude-desktop, vscode, cursor, windsurf, cline, trae, qoder, opencode. Есть и интерактивный режим npx yuque-mcp setup.

Токен лучше хранить в переменной окружения YUQUE_TOKEN, а не в общих файлах.

Подключение к клиентам

Команды и конфиг приведены дословно из README. Вместо значения YOUR_TOKEN подставьте свой токен. Подробнее — в инструкции как подключить MCP.

claude mcp add yuque -- npx -y yuque-mcp --token=YOUR_TOKEN

Для командного токена или частного развёртывания к команде установки добавляют --host с адресом пространства. После настройки перезапустите клиент.

Проверка

Попросите ассистента вызвать yuque_get_user: он вернёт данные пользователя, которому принадлежит токен. Затем запросите список ваших баз знаний.

Примеры задач

Найди в моём Yuque всё про канареечные релизы и сделай сводку на одну страницу.
Оформи сегодняшние заметки со встречи документом в базе знаний «Техническое исследование».
Добавь в проектный документ блок-схему этого конвейера развёртывания.

Риски

  • Изменение реального содержимого. Инструменты создания и изменения правят базы знаний, документы, оглавления и заметки. Сервер может всё, что разрешено токену, включая смену видимости базы знаний.
  • Токен. Храните его в секрете. Если работаете в одном пространстве, предпочтите командный токен, ограниченный этим пространством.
  • Сеть. Все запросы идут в API Yuque или на указанный адрес частного развёртывания.
  • Ограничения частоты. При ошибке 429 подождите и повторите запрос.

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

Можно ли изменить заголовок и текст документа одним вызовом?

Нет. yuque_update_doc не совмещает тело в markdown с изменением заголовка, адреса или видимости — метаданные обновляют отдельным вызовом.

Что делать при ошибке 401?

Токен недействителен или истёк — создайте новый в настройках разработчика Yuque.

Работают ли старые переменные окружения?

Да, YUQUE_PERSONAL_TOKEN и YUQUE_BASE_URL поддерживаются как запасные варианты, но в новых конфигах используйте YUQUE_TOKEN и YUQUE_HOST.

Основы протокола — на странице что такое MCP-сервер.

Похожие MCP-серверы

Memory

Эталонный сервер постоянной памяти на основе графа знаний.

Риск: high Лицензия: NOASSERTION ★ 92 089

Context7

Context7 даёт агентам актуальную документацию и примеры кода библиотек нужных версий.

Риск: medium Лицензия: MIT ★ 65 087

hindsight

Долговременная память для ИИ-агентов по образцу человеческой.

Риск: medium Лицензия: MIT ★ 61 836

cognee-mcp

Менеджер памяти cognee для ИИ-приложений на графовых и векторных хранилищах.

Риск: high Лицензия: Apache-2.0 ★ 33 236

Источники