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 в пределах прав токена.
Настройка клиентов
{
"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
Эталонный сервер постоянной памяти на основе графа знаний.
Context7
Context7 даёт агентам актуальную документацию и примеры кода библиотек нужных версий.
hindsight
Долговременная память для ИИ-агентов по образцу человеческой.
cognee-mcp
Менеджер памяти cognee для ИИ-приложений на графовых и векторных хранилищах.