语雀文档MCP工具是一个基于Session Cookie的语雀MCP服务器，安装后AI Agent可以直接读取语雀文档内容并转换为Markdown格式。支持列出知识库文档目录、读取渲染内容、保留PlantUML/Mermaid图表和代码块。兼容Claude Desktop、Cursor等主流MCP客户端，适合团队知识管理和AI文档分析场景。

语雀文档MCP工具 — 让AI直接读取语雀知识库文档的集成助手

【适用场景】

技术团队将产品需求、会议纪要、接口文档放在语雀，希望AI助手（如Claude）能直接读取和分析这些文档；知识工作者有大量语雀知识库文章，需要批量转换为Markdown格式进行二次整理；需要让AI根据语雀文档内容回答技术问题，而不是让AI凭空编造；想快速浏览语雀知识库的文档目录结构，找到特定主题的文档；语雀文档中包含PlantUML/Mermaid图表和代码块，需要保留这些格式进行转换；个人知识管理场景，将语雀作为个人知识库，AI助手帮助检索和总结。

【操作步骤】

第一步：安装 Yuque MCP Tool ```

pip安装（推荐）

pip install yuque-mcp-tool

安装Playwright浏览器（可选，用于渲染JS页面）

python -m playwright install chromium

或从源码安装

git clone https://github.com/andy8663/yuque-mcp-tool.git cd yuque-mcp-tool pip install -e . ```

第二步：获取语雀 Session Cookie 方法一（推荐）： 1. 登录语雀 https://www.yuque.com 2. 按 F12 打开浏览器开发者工具，切换到「应用 Application」面板 3. 左侧展开「存储」→「Cookie」→ 点击 https://www.yuque.com 4. 找到 _yuque_session，复制其「值」列的内容

方法二（Console命令）： 1. 登录语雀 2. 按 F12 → Console 中输入：copy(document.cookie) 3. 复制输出，从结果中找到 _yuque_session=xxx 的值

Session 有效期约 30 天，过期后需重新获取。

第三步：配置 MCP 客户端 在客户端配置文件中添加： ```json { "mcpServers": { "yuque": { "command": "yuque-mcp", "env": { "YUQUE_SESSION": "YOUR_YUQUE_SESSION", "YUQUE_HOST": "https://www.yuque.com" } } } } ```

各客户端配置文件位置： - Claude Desktop (macOS)：~/Library/Application Support/Claude/claude_desktop_config.json - Claude Desktop (Windows)：%APPDATA%\Claude\claude_desktop_config.json - Cursor：.cursor/mcp.json（项目根目录）

第四步：使用三大核心工具

工具1：yuque_list_docs（列出知识库文档）参数：repo_slug（必填），host（可选）示例：列出知识库 cc9c0g/rebell 里的所有文档

工具2：yuque_read_markdown（读取并转换Markdown，推荐）参数：url（必填），include_stats（可选）特点：转换为Markdown，保留表格、PlantUML/Mermaid图表、代码块、图片、链接和画板摘要

工具3：yuque_read（读取渲染内容）参数：url（必填）返回：渲染后的文本内容

【代码模板】

示例1：让AI读取语雀技术文档 用户：「帮我读取这个语雀文档，分析其中的API接口设计：https://www.yuque.com/cc9c0g/rebell/hf0gch」 → yuque_read_markdown(url) → AI分析文档内容，给出API设计建议

示例2：批量整理知识库目录 用户：「列出语雀知识库 cc9c0g/rebell 里所有文档标题」 → yuque_list_docs(repo_slug='cc9c0g/rebell') → 整理文档清单，按主题分类

示例3：AI结合语雀文档回答问题 用户：「我们的产品需求文档在语雀里，关于用户权限管理的那篇在哪里？」 → yuque_list_docs列出目录 → AI根据标题和摘要判断最相关的文档 → 再yuque_read_markdown读取具体内容

【复盘要点】

1. Session Cookie 安全：Cookie相当于登录凭证，不要分享给他人；过期后重新获取即可 2. 渲染模式选择：默认auto（自动判断），复杂JS页面设 YUQUE_RENDER_MODE=force 3. Markdown格式保留：推荐使用 yuque_read_markdown 而非 yuque_read，可保留PlantUML图表和代码块 4. 团队知识库场景：适合团队将语雀作为内部Wiki，AI助手帮助快速检索和分析 5. 配置问题排查：Session无效/读取失败时，先重新登录语雀获取新Session，再检查 YUQUE_HOST 是否正确

**来源：ClawHub https://clawhub.ai/andy8663/yuque-mcp-tool