语雀 MCP 服务器 (Enhanced)

通过 MCP 协议让 AI 助手管理你的语雀文档。支持 Cookie 自动化登录，无需超级会员。

Enhanced fork based on xiaocong/yuque-cookie-mcp v1.0.2 (original repo unavailable as of 2026-07)

此 Fork 新增功能

工具	分类	说明
create_repo	知识库管理	创建新知识库（Cookie 模拟网页操作）
delete_repo	知识库管理	删除知识库
list_notes	小记管理	列出所有小记（分页支持）
get_note	小记管理	获取单篇小记完整内容
create_note	小记管理	创建小记（lake 格式）
update_note	小记管理	更新小记内容

小记功能通过语雀网页内部 API (/api/modules/note/notes/NoteController) 实现，官方 OpenAPI 不覆盖小记，仅 Cookie 模式下可用。

功能

通用工具

工具	说明
check_auth_status	检查认证状态和 Cookie 有效期
refresh_cookie	刷新 Cookie（自动打开浏览器登录）
get_user_info	获取当前用户信息
get_doc_by_url	通过语雀链接直接获取文档（支持个人/公司空间）

知识库管理

工具	说明
list_repos	列出所有知识库
get_repo	获取知识库详情
create_repo	创建新知识库
delete_repo	删除知识库
get_repo_toc	获取知识库目录结构

文档操作

工具	说明
list_docs	列出知识库文档
get_doc	获取文档内容
create_doc	创建文档
update_doc	更新文档
delete_doc	删除文档
search_docs	搜索文档

小记管理（新增）

工具	说明
list_notes	列出所有小记（支持分页）
get_note	获取单篇小记完整内容
create_note	创建小记（lake 格式）
update_note	更新小记

公司空间

工具	说明
list_org_repos	列出公司空间的知识库
list_org_docs	列出公司空间知识库的文档
get_org_doc	获取公司空间文档内容
create_org_doc	在公司空间创建文档
update_org_doc	更新公司空间文档

安装

npm install -g github:dove-yang/yuque-cookie-mcp

首次登录

运行以下命令，会自动打开浏览器让你登录语雀：

cd ~/myCode/mcp/yuque-mcp
npm run login

登录成功后，Cookie 会自动保存到 ~/.yuque-mcp/cookies.json，有效期约 2 周。

配置 Cursor

编辑 ~/.cursor/mcp.json，添加：

{
  "mcpServers": {
    "yuque": {
      "command": "node",
      "args": ["/Users/xiaocong/myCode/mcp/yuque-mcp/dist/index.js"]
    }
  }
}

注意：使用 Cookie 方式不需要配置环境变量。

认证方式

方式一：Cookie 自动登录（推荐，免费）

1. 运行 npm run login
2. 在打开的浏览器中登录语雀
3. 登录成功后自动保存 Cookie

Cookie 过期后，在对话中说"刷新语雀 Cookie"即可重新登录。

方式二：Token（需要超级会员）

如果你有语雀超级会员，可以使用 Token：

{
  "mcpServers": {
    "yuque": {
      "command": "node",
      "args": ["/Users/xiaocong/myCode/mcp/yuque-mcp/dist/index.js"],
      "env": {
        "YUQUE_TOKEN": "你的语雀Token"
      }
    }
  }
}

使用示例

配置完成后，在 Cursor 中可以这样对话：

• "检查语雀认证状态"
• "帮我看看我有哪些知识库"
• "帮我建一个叫 agent 的知识库" ← 新增
• "列出 xxx 知识库的目录结构"
• "帮我在 xxx 知识库创建一篇文档，记录今天的会议纪要"
• "更新 xxx 文档，把刚才讨论的内容加进去"
• "搜索关于 xxx 的文档"
• "查看 https://www.yuque.com/xxx/xxx/xxx 这个文档" ← 直接通过链接获取
• "查看公司空间的知识库"
• "查看后端专区这个知识库的文档目录"
• "帮我看看昨天写了哪些小记" ← 新增
• "创建一篇小记记录今天的想法" ← 新增

Cookie 说明

• Cookie 保存位置：~/.yuque-mcp/cookies.json
• 默认有效期：14 天
• 如果经常使用语雀网页版，Cookie 会自动续期
• 过期后说"刷新语雀 Cookie"即可重新登录

开发

# 克隆仓库
git clone https://github.com/dove-yang/yuque-cookie-mcp.git
cd yuque-cookie-mcp

# 手动登录获取 Cookie
node login.js

# 启动服务器
node index.js

License

MIT — forked from xiaocong/yuque-cookie-mcp