语雀 MCP 服务器 (Enhanced)

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

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

此 Fork 新增功能

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

功能

通用工具

知识库管理

文档操作

小记管理（新增）

公司空间

安装

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