Yuque MCP 41c21017

MCP文档知识

提供方 EnglandLobster

文档知识 stdio · 本地进程 Token 社区 / 第三方 Claude DesktopClaude
查看接入方式

为语雀知识库提供的模型上下文协议(MCP)服务器,支持文档、知识库和目录的管理与搜索功能。

一句话选型结论

按资料字段整理

Yuque MCP 41c21017 属于文档知识类 MCP 服务器,stdio · 本地进程,Token,可直接接入 Claude Desktop、Claude,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类文档知识 传输方式stdio · 本地进程 鉴权Token 部署方式本地部署
GitHub 星标 2 仓库热度,无公开仓库时显示未标注
工具数 11 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

文档知识
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量11暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

知识管理Python本地部署文档处理API集成自动化工具Claude集成

安装与配置

stdio · 本地进程 Token
客户端在本机拉起子进程,数据不出本机
pip install -e .

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Node.js 等运行时,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 11 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
文档检索问答

在你的文档库里按问题找答案。

知识库读写

把新资料写进知识库,随用随取。

内容整理

把零散资料归纳成结构化笔记。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 11 个工具,覆盖面较广,能满足多种调用。
  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude Desktop、Claude,换客户端不用重新研究配置。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 使用前要准备好Token对应的凭据,并按最小权限配置。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在文档知识场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Yuque MCP 41c21017当前 11 stdio · 本地进程 本地部署 有 2026-05-17
dify 未标注 stdio · 本地进程 本地部署 有 2026-04-11
open-webui 未标注 stdio · 本地进程 本地部署 有 2026-04-11
JeecgBoot 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Cherry Studio 未标注 未标注 未标注 无 2026-05-17
mempalace 未标注 stdio · 本地进程 本地部署 有 2026-04-11

服务器档案

文档知识
字段来自项目仓库与公开索引,中文说明由本站标注
提供方EnglandLobster上游标注的维护方 EnglandLobster
分类文档知识本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式Token远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

6.9 KB
来自项目仓库与上游目录的原文,未做删改

Yuque MCP Server

English | 简体中文

为 语雀(Yuque) 提供的模型上下文协议(MCP)服务器 - 让 Claude 等 AI 助手能够通过标准化工具管理你的语雀知识库。

功能特性

文档管理

  • ✅ 创建、读取、更新和删除文档
  • ✅ 支持多种格式(Markdown、HTML、Lake)
  • ✅ 分页列出文档
  • ✅ 一步创建文档并添加到目录 (create_document_with_toc)

知识库管理

  • ✅ 一次调用获取所有知识库 (get_my_repositories)
  • ✅ 查看知识库及完整目录结构 (get_repository_overview)
  • ✅ 创建新知识库

目录管理

  • ✅ 知识库概览中包含层级目录视图
  • ✅ 在目录中添加/移动/删除文档
  • ✅ 使用文件夹组织内容

搜索与发现

  • ✅ 一次调用搜索并读取文档 (search_and_read)
  • ✅ 获取当前用户信息

安装

前置要求

  • Python 3.10 或更高版本
  • 语雀账号及 API Token

快速开始

  1. 克隆仓库bash git clone https://github.com/EnglandLobster/yuque-mcp.git cd yuque-mcp

  2. 安装依赖bash pip install -e .

或使用 uv:bash uv venv uv pip install -e .

  1. 配置 API Tokenbash cp .env.example .env

从这里获取你的 API Token:https://www.yuque.com/settings/tokens

编辑 .env 文件:env YUQUE_API_TOKEN=你的token YUQUE_BASE_URL=https://www.yuque.com

使用方法

与 Claude Code CLI 集成

添加到 ~/.claude.json 或项目级别的 .mcp.json:```json
{
"mcpServers": {
"yuque": {
"type": "stdio",
"command": "/path/to/yuque-mcp/.venv/bin/python",
"args": ["-m", "yuque_mcp.server"],
"env": {
"YUQUE_API_TOKEN": "你的token"
}
}
}
}


或通过 CLI 添加:```bash
claude mcp add --scope user --transport stdio \
  --env YUQUE_API_TOKEN=你的token \
  yuque -- python -m yuque_mcp.server

与 Claude Desktop 集成

添加到 Claude Desktop 配置文件:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: `%APPDATA%\Claude\claude_desktop_config.json````json
{
"mcpServers": {
"yuque": {
"command": "python",
"args": ["-m", "yuque_mcp.server"],
"env": {
"YUQUE_API_TOKEN": "你的token"
}
}
}
}


### 独立运行```bash
# 使用安装的脚本
yuque-mcp

# 或直接运行
python -m yuque_mcp.server

可用工具(11 个工具)

文档操作(5 个工具)

工具 描述
create_document_with_toc 一步创建文档并添加到目录(推荐)
get_document 获取文档内容和元数据
update_document 更新文档标题、内容或设置
delete_document 删除文档
list_documents 分页列出所有文档

知识库操作(3 个工具)

工具 描述
get_my_repositories 一次获取当前用户信息和所有知识库
get_repository_overview 一次获取知识库详情和目录结构
create_repository 创建新知识库

目录管理(1 个工具)

工具 描述
update_toc 添加、移动或删除目录项

搜索与用户(2 个工具)

工具 描述
search_and_read 一次搜索并读取第一个结果
get_current_user 获取认证用户信息

常见工作流

创建文档(推荐方式)

使用 create_document_with_toc 一步完成创建:```python
create_document_with_toc(
repo_id="123",
title="快速开始",
body="# 欢迎\n\n你的内容...",
parent_uuid="folder-uuid" # 可选,省略则添加到根目录
)


### 创建文档(两步方式)

如果需要更多控制:

1. 创建文档:```python
   create_document(repo_id="123", title="我的文档", body="# 内容")
   ```

2. 添加到目录:```python
   update_toc(repo_id="123", action="appendNode", action_mode="child",
              doc_ids="456", node_type="DOC")
   ```

### 浏览知识库结构```python
get_toc(repo_id="123")

返回带有文件夹(📁)和文档(📄)的层级结构。

配置

环境变量

变量 必需 默认值 描述
YUQUE_API_TOKEN 是 - 你的语雀 API Token
YUQUE_BASE_URL 否 https://www.yuque.com 语雀 API 基础 URL

可见性级别

值 含义
0 私密(默认)
1 公开
2 内部可见(仅组织成员)

内容格式

格式 描述
markdown 标准 Markdown(默认)
html HTML 格式
lake 语雀原生富文本格式

错误处理

服务器提供双语错误消息(中文 + 英文):

状态码 消息
400 请求参数非法 (Invalid request parameters)
401 Token/Scope 未通过鉴权 (Authentication failed)
403 无操作权限 (Permission denied)
404 实体未找到 (Entity not found)
422 请求参数校验失败 (Validation failed)
429 访问频率超限 (Rate limit exceeded)
500 内部错误 (Internal server error)

开发

设置开发环境```bash

克隆并安装开发依赖

git clone https://github.com/EnglandLobster/yuque-mcp.git
cd yuque-mcp
pip install -e ".[dev]"


### 运行测试```bash
pytest
pytest --cov=yuque_mcp  # 带覆盖率报告

代码质量检查```bash

ruff check . # 代码检查
ruff format . # 代码格式化
mypy src/yuque_mcp # 类型检查


### 项目结构```
yuque-mcp/
├── src/yuque_mcp/
│   ├── __init__.py    # 包导出
│   ├── server.py      # FastMCP 服务器(11 个工具)
│   ├── client.py      # 异步语雀 API 客户端
│   └── models.py      # Pydantic 模型和枚举
├── tests/
│   ├── __init__.py
│   ├── conftest.py    # Pytest 固件
│   └── test_client.py # 客户端测试
├── .env.example
├── .github/
│   └── workflows/
│       └── ci.yml     # GitHub Actions CI
├── pyproject.toml
├── LICENSE
├── CLAUDE.md          # AI 助手使用说明
└── README.md

贡献

欢迎贡献!请遵循以下步骤:

  1. Fork 本仓库
  2. 创建特性分支 (git checkout -b feature/amazing-feature)
  3. 进行修改
  4. 运行测试 (pytest)
  5. 运行代码检查 (ruff check . && ruff format .)
  6. 提交更改 (git commit -m 'Add amazing feature')
  7. 推送到分支 (git push origin feature/amazing-feature)
  8. 开启 Pull Request

API 参考

  • 语雀 API 文档:https://www.yuque.com/yuque/developer/api
  • MCP 规范:https://modelcontextprotocol.io
  • FastMCP 文档:https://gofastmcp.com

许可证

本项目采用 MIT 许可证 - 详见 LICENSE 文件。

致谢

  • 语雀(Yuque) - 知识库平台
  • Anthropic - 模型上下文协议
  • FastMCP - 高级 MCP Python SDK

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
Yuque MCP 41c21017 怎么安装?

在客户端按下面的安装命令接入:pip install -e .。装完在客户端配置里引用同一个包或端点。

Yuque MCP 41c21017 怎么在 Claude Desktop、Claude 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Yuque MCP 41c21017 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Yuque MCP 41c21017 需要 API Key 吗?

资料标注需要Token认证,使用前准备好对应凭据,并按最小权限配置。

Yuque MCP 41c21017 支持哪些客户端?

资料标注支持 Claude Desktop、Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Yuque MCP 41c21017 能提供哪些能力?

资料显示约 11 个工具;能力标签包括 知识管理、文档处理、Python、Claude、API集成。具体工具清单以官方文档为准。

Yuque MCP 41c21017 需要什么运行环境?

属于本地进程,需要在本机装好运行环境。

Yuque MCP 41c21017 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。