让 Claude 直接读写你的语雀知识库！这款开源工具太香了-平芜编程栈

🔥 让 Claude 直接读写你的语雀知识库！这款开源工具太香了

AI时代的知识管理困境

你是否也曾遇到过这样的场景：

💻 写代码时，想查阅团队的技术文档，却要切出 IDE，打开浏览器，登录语雀，搜索关键词…
📝 让 AI 帮你整理文档，结果它完全不知道你知识库里有哪些内容
🔄 团队知识库沉淀了大量干货，却无法与 AI 工作流无缝集成

如果 Claude 能直接访问你的语雀知识库，会是什么体验？

今天给大家介绍一个开源项目 ——yuque-mcp，让你的 Claude Desktop 或 Claude Code CLI 与语雀知识库完美融合！

🎯 什么是 yuque-mcp？

yuque-mcp是一个基于Model Context Protocol (MCP)标准开发的服务器，打通了 Claude Desktop 与语雀知识库之间的壁垒。

简单来说：安装后，Claude 就能直接搜索、读取、创建、更新语雀文档了！

✨ 核心功能一览

🔍 智能搜索 (search)

一句话找到你需要的文档：

“帮我搜索关于 TypeScript 类型系统的语雀文档”

📁 目录浏览 (get_toc)

一键获取知识库完整结构：

“查看我们团队知识库的目录结构”

📖 内容读取 (get_doc)

精准获取文档详细内容：

“获取文档 123456 的完整内容”

✍️ 文档创建 (create_doc)

AI 直接帮你写文档并发布到语雀：

“创建一篇部署指南，内容包括环境准备和部署步骤”

📝 文档更新 (update_doc)

直接修改已有文档，无需手动打开编辑器：

“更新文档 123456，在末尾添加今天的工作总结”

💡 真实使用场景

场景一：代码开发时查阅文档

你：我想用 React 实现一个表单验证，但不确定团队的最佳实践 Claude：让我先搜索一下你们语雀知识库中的相关文档... [已搜索到 3 篇相关文档] 根据你们团队的《React 表单开发规范》，推荐使用 react-hook-form... 你：太方便了！不用切出去查文档了！

场景二：AI 辅助文档编写

你：帮我把今天的会议记录整理成文档，发到语雀"项目纪要"分类下 Claude：好的，我先查看目录结构找到对应分类... [已获取目录结构] 正在创建文档《2024-01-28 产品需求评审会》... 文档已创建完成！访问链接：https://www.yuque.com/...

场景三：迭代更新文档

你：把刚才讨论的方案更新到《技术方案文档》里 Claude：好的，我先获取文档当前内容... [已获取文档内容] 正在更新文档，在"方案对比"章节添加新内容... 文档已更新完成！查看链接：https://www.yuque.com/...

场景四：知识库智能问答

你：我们之前是怎么解决跨域问题的？ Claude：让我搜索一下... [找到文档《前端跨域问题解决方案》] 根据你们的技术文档，团队采用的是 Nginx 反向代理方案...

🛠️ 技术亮点

标准化协议：基于 MCP 标准，与 Claude Desktop 原生集成
双模式支持：同时支持 Claude Desktop 和 Claude Code CLI
TypeScript 打造：类型安全，代码优雅
零依赖负担：核心依赖仅 @modelcontextprotocol/sdk 和 zod
开箱即用：简单配置即可使用

🚀 3分钟快速上手

1️⃣ 安装项目

gitclone https://github.com/wangx-wx/yuque-mcp.gitcdyuque-mcpnpminstallnpmrun build

2️⃣ 获取语雀 Token

访问语雀 Token 管理页面创建个人 Token，需要勾选read和write权限。

3️⃣ 配置方式（二选一）

方式A：Claude Desktop 配置文件

编辑配置文件（Windows 为%APPDATA%\Claude\claude_desktop_config.json，macOS 为~/Library/Application Support/Claude/claude_desktop_config.json）：

{"mcpServers":{"yuque":{"command":"node","args":["E:\\node\\yuque-mcp\\dist\\index.js"],"env":{"YUQUE_AUTH_TOKEN":"你的语雀Token","YUQUE_BASE_URL":"https://www.yuque.com","YUQUE_GROUP_LOGIN":"团队路径名（如 leyaoyao）","YUQUE_BOOK_SLUG":"知识库路径（如 fe-docs）"}}}}

💡如何获取参数？打开你的语雀知识库，URL 格式为https://www.yuque.com/{group_login}/{book_slug}，从中提取即可。

方式B：Claude Code CLI 配置（推荐）

如果你使用Claude Code命令行工具，可以通过 CLI 快速添加：

macOS / Linux：

claude mcpaddyuque-mcp\--scope project\--transport stdio\--node"/path/to/yuque-mcp/dist/index.js"\--envYUQUE_AUTH_TOKEN=your-auth-token-here\--envYUQUE_BASE_URL=https://www.yuque.com\--envYUQUE_GROUP_LOGIN=your-group-login\--envYUQUE_BOOK_SLUG=your-book-slug

Windows (PowerShell)：

claude mcp add yuque-mcp `--scope project `--transport stdio `--node"D:/yuque-mcp/dist/index.js"`--env YUQUE_AUTH_TOKEN=your-auth-token-here `--env YUQUE_BASE_URL=https://www.yuque.com `--env YUQUE_GROUP_LOGIN=your-group-login`--env YUQUE_BOOK_SLUG=your-book-slug

CLI 配置优势：

无需手动编辑 JSON 文件
支持项目级配置（--scope project），每个项目可独立配置
快速切换不同知识库环境

4️⃣ 重启并验证

Claude Desktop：重启应用后即可使用
Claude Code：直接输入claude进入对话，工具会自动加载

大功告成！现在就可以在对话中让 Claude 访问你的语雀知识库了！

🎁 项目地址

GitHub：https://github.com/wangx-wx/yuque-mcp

⭐如果这个项目对你有帮助，欢迎给个 Star！

📌 写在最后

AI 的未来不是取代人类，而是成为我们最得力的助手。

当 Claude 能够直接访问你的团队知识库，它就不再是一个通用的 AI 助手，而是一个真正懂你、懂你业务的AI 团队伙伴。

yuque-mcp只是开始，期待 MCP 生态带来更多可能性！

💬你有什么期待的场景或想法？欢迎在评论区留言！

让 Claude 直接读写你的语雀知识库！这款开源工具太香了