语雀知识库连接器

概述

本技能指导配置语雀官方 MCP Server（yuque-mcp），将 WorkBuddy 与语雀知识库打通。配置完成后，可通过 MCP 工具直接搜索、创建、更新语雀文档，上传文件到指定知识库文件夹。

前置条件

• Node.js v18+（WorkBuddy 已内置）
• 语雀个人访问令牌（Token）

Token 获取

前往 语雀 Token 设置页 创建个人访问令牌。登录语雀 → 点击头像 → 「设置」 → 左侧菜单「Tokens」 → 创建新令牌。

配置步骤

1. 获取 Token

询问用户提供语雀 Token。若没有，指导其按上方步骤获取。

2. 写入 MCP 配置

读取 ~/.workbuddy/mcp.json，合并写入以下配置：

{
  "mcpServers": {
    "yuque": {
      "command": "npx",
      "args": ["-y", "yuque-mcp"],
      "env": {
        "YUQUE_PERSONAL_TOKEN": "<用户的Token>"
      }
    }
  }
}

注意：若已有其他 mcpServers 条目，只新增 yuque 条目，保留已有配置。

3. 激活连接器

告知用户：打开 WorkBuddy 左侧连接器管理页面，找到 yuque 连接器，点击「信任」激活。

配置完成后的可用工具

激活后提供 19 个 MCP 工具，按场景分类：

典型使用场景

上传文件到语雀知识库

1. 使用 yuque_list_books 列出知识库，找到目标知识库的 book_id
2. 使用 yuque_get_toc 获取目录结构，找到目标文件夹的 doc_id
3. 使用 yuque_create_resource 上传文件
4. 使用 yuque_create_doc 在指定目录下创建文档（引用上传的资源）

在语雀创建文档

1. 使用 yuque_list_books 找到目标知识库
2. 使用 yuque_create_doc 创建文档，传入 title、body（Markdown 格式）、book_id

搜索语雀内容

1. 使用 yuque_search，传入搜索关键词
2. 根据返回结果读取具体文档

常见问题

API 基准

• Base URL: https://www.yuque.com/api/v2
• 认证: 请求头 X-Auth-Token
• npm 包: yuque-mcp
• 官方仓库: https://github.com/yuque/yuque-mcp-server