用途:yuque-mcp-server 是一个 Model Context Protocol(MCP)服务器,把语雀(Yuque)知识库 API 暴露给 AI 助手,使其能搜索文档、创建与更新内容、管理知识库(书籍)及访问资源,共提供 19 个工具。
主要能力:用户信息查询(yuque_get_user);全局搜索(yuque_search,支持 doc、book、user 类型);知识库管理(yuque_list_books、yuque_get_book、yuque_create_book、yuque_update_book);文档管理(yuque_list_docs、yuque_get_doc、yuque_create_doc、yuque_update_doc,支持 markdown、lake、html 格式);资源管理(yuque_get_resource、yuque_create_resource、yuque_update_resource);目录管理(yuque_get_toc、yuque_update_toc);个人笔记(yuque_list_notes、yuque_get_note、yuque_create_note、yuque_update_note)。支持个人令牌、团队令牌与私有部署。
使用方式:通过 CLI 自动配置,如 npx yuque-mcp setup 或 npx yuque-mcp install --token=$YUQUE_TOKEN --client=cursor;支持 claude-desktop、vscode、cursor、windsurf、cline、trae、qoder、opencode 等客户端。也可手动配置,在 claude_desktop_config.json 或 mcp.json 中加入 npx -y yuque-mcp 及 YUQUE_TOKEN 环境变量;VS Code 使用 .vscode/mcp.json。需要 Node.js v18 或更高版本,令牌在语雀开发者设置中创建。配置变量包括 YUQUE_TOKEN、YUQUE_HOST(团队令牌或私有部署)。
适用场景:让 AI 助手检索语雀文档、创建工程笔记、更新 API 指南、整理知识库结构及统计文档数量等。
限制:官方资料未提供收费标准或价格信息;需要有效的语雀令牌,令牌无效会返回 401;请求过频可能返回 429 限流;已删除资源返回 410;配置错误或 Node.js 缺失会导致服务器无法加载,需检查客户端日志与 JSON 语法。