语雀 MCP 服务器

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

功能

通用工具

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

个人空间

| 工具 | 说明 | |------|------| | list_repos | 列出所有知识库 | | get_repo | 获取知识库详情 | | get_repo_toc | 获取知识库目录结构 | | list_docs | 列出知识库文档 | | get_doc | 获取文档内容 | | create_doc | 创建文档 | | update_doc | 更新文档 | | delete_doc | 删除文档 | | search_docs | 搜索文档 |

公司空间

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

安装

cd ~/myCode/mcp/yuque-mcp
npm install
npm run build

首次登录

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

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 中可以这样对话：

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

Cookie 说明

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

开发

# 开发模式
npm run dev

# 构建
npm run build

# 手动登录获取 Cookie
npm run login

License

MIT