{"_id":"@chaoyum/yuque-mcp-server","_rev":"4-90cc17cbf239ad7c75e945d25f068063","name":"@chaoyum/yuque-mcp-server","dist-tags":{"latest":"1.1.0"},"versions":{"1.0.0":{"name":"@chaoyum/yuque-mcp-server","version":"1.0.0","keywords":["mcp","yuque","markdown","语雀"],"license":"MIT","_id":"@chaoyum/yuque-mcp-server@1.0.0","maintainers":[{"name":"chaoyum","email":"2807336762@qq.com"}],"bin":{"yuque-mcp-server":"dist/index.js"},"dist":{"shasum":"448a271793c7bc2af9c2d96d9712cf689f2c3f3c","tarball":"https://registry.npmjs.org/@chaoyum/yuque-mcp-server/-/yuque-mcp-server-1.0.0.tgz","fileCount":14,"integrity":"sha512-fWJPwV7vdd0LtddJz6GLDYgfm39loypdYvRVCnKVYuqpYknPmFndXJdfcHfN2Ns1ftkFlAee7c9XbR7TZEp33A==","signatures":[{"sig":"MEYCIQDBTr8mJZUSkPA7UycF4RacIM+ykuTPsfzpnbwF7vrCQQIhAKlooMJX70CRL9gDTzus6WvxrpvjT6HL+Yaqk8KMNBvl","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":52338},"type":"module","scripts":{"dev":"tsc --watch","build":"tsc","start":"node dist/index.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"chaoyum","email":"2807336762@qq.com"},"_npmVersion":"11.6.2","description":"A MCP Server for Yuque - download docs as local .md files and upload .md files to Yuque","directories":{},"_nodeVersion":"24.12.0","dependencies":{"zod":"^3.24.4","@modelcontextprotocol/sdk":"^1.12.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.3","@types/node":"^22.15.1"},"_npmOperationalInternal":{"tmp":"tmp/yuque-mcp-server_1.0.0_1775120613851_0.8931061273559839","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@chaoyum/yuque-mcp-server","version":"1.0.1","keywords":["mcp","yuque","markdown","语雀"],"license":"MIT","_id":"@chaoyum/yuque-mcp-server@1.0.1","maintainers":[{"name":"chaoyum","email":"2807336762@qq.com"}],"bin":{"yuque-mcp-server":"dist/index.js"},"dist":{"shasum":"b7fe2307b93bc03f89ea593ecaec49155305e432","tarball":"https://registry.npmjs.org/@chaoyum/yuque-mcp-server/-/yuque-mcp-server-1.0.1.tgz","fileCount":14,"integrity":"sha512-mzhC+q6dlMIRWbsq+gjm3DuH4WgPFDeRA5uMprOu2wVMxKqds7eRw3qRDTPxBrV+a85JEDMh6p0e8FitFQwuvQ==","signatures":[{"sig":"MEYCIQCr1/RnEuvtG3jaiK2cA53GowICwLEYU/sMvrczLVLIwgIhAJYy8AbV42oILsRQQEtNxhSnKylOFjHOtJGj6c34tdeE","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":54122},"type":"module","scripts":{"dev":"tsc --watch","build":"tsc","start":"node dist/index.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"chaoyum","email":"2807336762@qq.com"},"_npmVersion":"11.6.2","description":"A MCP Server for Yuque - download docs as local .md files and upload .md files to Yuque","directories":{},"_nodeVersion":"24.12.0","dependencies":{"zod":"^3.24.4","@modelcontextprotocol/sdk":"^1.12.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.3","@types/node":"^22.15.1"},"_npmOperationalInternal":{"tmp":"tmp/yuque-mcp-server_1.0.1_1775121794379_0.07248208843453274","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"@chaoyum/yuque-mcp-server","version":"1.0.2","keywords":["mcp","yuque","markdown","语雀"],"license":"MIT","_id":"@chaoyum/yuque-mcp-server@1.0.2","maintainers":[{"name":"chaoyum","email":"2807336762@qq.com"}],"bin":{"yuque-mcp-server":"dist/index.js"},"dist":{"shasum":"22d9acc62f0dfb847a82327ef69f53942b32be5e","tarball":"https://registry.npmjs.org/@chaoyum/yuque-mcp-server/-/yuque-mcp-server-1.0.2.tgz","fileCount":14,"integrity":"sha512-t4UJz4K25qBb/1Nu3ISB/SdK3KGOK+tu1HvI5crxyMNoddqZDNaQSvq/g+vofq/QdE9vpiCoupGMDHi8QEb+nA==","signatures":[{"sig":"MEUCIQCRQfGDgICRcvX69ZVROdeVRmZFdcugff58fV9YkHadEAIgXKjS1Co2zJOhss43fbN68WdWudaHGDuhOSaQnrDDcFU=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":56034},"type":"module","scripts":{"dev":"tsc --watch","build":"tsc","start":"node dist/index.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"chaoyum","email":"2807336762@qq.com"},"_npmVersion":"11.6.2","description":"A MCP Server for Yuque - download docs as local .md files and upload .md files to Yuque","directories":{},"_nodeVersion":"24.12.0","dependencies":{"zod":"^3.24.4","@modelcontextprotocol/sdk":"^1.12.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.3","@types/node":"^22.15.1"},"_npmOperationalInternal":{"tmp":"tmp/yuque-mcp-server_1.0.2_1775130728642_0.4660374478615581","host":"s3://npm-registry-packages-npm-production"}},"1.1.0":{"name":"@chaoyum/yuque-mcp-server","version":"1.1.0","publishConfig":{"access":"public"},"description":"A MCP Server for Yuque - download docs as local .md files and upload .md files to Yuque","type":"module","bin":{"yuque-mcp-server":"dist/index.js"},"scripts":{"build":"tsc","prepublishOnly":"npm run build","start":"node dist/index.js","dev":"tsc --watch"},"keywords":["mcp","yuque","markdown","语雀"],"license":"MIT","dependencies":{"@modelcontextprotocol/sdk":"^1.12.1","zod":"^3.24.4"},"devDependencies":{"@types/node":"^22.15.1","typescript":"^5.8.3"},"_id":"@chaoyum/yuque-mcp-server@1.1.0","_nodeVersion":"24.12.0","_npmVersion":"11.6.2","dist":{"integrity":"sha512-CMArE8/lHuSA45lR+Q1fmhYUuespe+/VlAVm6j0ERlDS32ttzKPh/p8TGDnmMBQocKQ+YkTyvAd3BOqWr9/Vnw==","shasum":"83265c031855c2ba6cd672a32e3a966573710e51","tarball":"https://registry.npmjs.org/@chaoyum/yuque-mcp-server/-/yuque-mcp-server-1.1.0.tgz","fileCount":14,"unpackedSize":85553,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDCoy/RCfk5FbnNQeR1JNW+YYWL3t3ZmnZ1TJFsWSJx4gIgBAZ9f+H1aF53o7skM/YJBjCn5fTvGuTVhuhhOG6VOT8="}]},"_npmUser":{"name":"chaoyum","email":"2807336762@qq.com"},"directories":{},"maintainers":[{"name":"chaoyum","email":"2807336762@qq.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/yuque-mcp-server_1.1.0_1775198327104_0.3584286481920098"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-02T09:03:33.739Z","modified":"2026-04-03T06:38:47.521Z","1.0.0":"2026-04-02T09:03:33.995Z","1.0.1":"2026-04-02T09:23:14.521Z","1.0.2":"2026-04-02T11:52:08.795Z","1.1.0":"2026-04-03T06:38:47.317Z"},"license":"MIT","keywords":["mcp","yuque","markdown","语雀"],"description":"A MCP Server for Yuque - download docs as local .md files and upload .md files to Yuque","maintainers":[{"name":"chaoyum","email":"2807336762@qq.com"}],"readme":"# @chaoyum/yuque-mcp-server\r\n\r\n语雀 MCP Server —— 在 Cursor 中管理语雀文档。支持下载、上传、更新、子文档创建、目录定位、知识库搜索等。兼容团队版语雀（如 `bd-tech.yuque.com`）和个人版，同时支持 Cookie 和 Token 认证。\r\n\r\n## 功能\r\n\r\n| 工具名 | 说明 |\r\n|--------|------|\r\n| `download_yuque_doc` | 输入语雀文档链接，导出为 Markdown 并保存到当前工作区的 `yuque-downloads/` 目录 |\r\n| `upload_to_yuque` | 上传或更新语雀文档，支持三种模式：创建新文档、更新已有文档、创建子文档。可指定目录分组位置 |\r\n| `list_yuque_repos` | 列出/搜索当前用户的所有知识库，按名称模糊匹配 |\r\n| `list_yuque_toc` | 查看知识库的目录结构（树形展示分组、文档、子文档层级） |\r\n| `update_yuque_config` | 更新语雀配置（域名、Cookie、Token），即时生效无需重启 |\r\n| `check_yuque_connection` | 检测语雀连接状态和认证是否有效 |\r\n\r\n## 前置条件\r\n\r\n- Node.js >= 18\r\n- 语雀账号（个人版或团队版均可）\r\n\r\n## 认证方式\r\n\r\n支持 **Cookie** 和 **Token** 两种认证，**都跟域名绑定，不同域名的凭据不能混用**。\r\n\r\n| 方式 | 适用场景 | 获取方法 |\r\n|------|---------|---------|\r\n| Cookie（推荐） | 所有用户，免费 | 浏览器登录语雀 → F12 → Network → 任意请求 → Headers → Cookie 值全部复制 |\r\n| Token | 语雀超级会员 | 语雀 → 设置 → Token → 新建 |\r\n\r\n## 安装与配置\r\n\r\n### 方式一：通过 npx 直接使用（推荐）\r\n\r\n编辑 `~/.cursor/mcp.json`，添加：\r\n\r\n```json\r\n{\r\n  \"mcpServers\": {\r\n    \"yuque-mcp\": {\r\n      \"command\": \"npx\",\r\n      \"args\": [\"-y\", \"@chaoyum/yuque-mcp-server@latest\"],\r\n      \"env\": {\r\n        \"YUQUE_HOST\": \"https://bd-tech.yuque.com\",\r\n        \"YUQUE_TOKEN\": \"\",\r\n        \"YUQUE_COOKIE\": \"\",\r\n        \"YUQUE_COOKIE_FILE\": \"\"\r\n      }\r\n    }\r\n  }\r\n}\r\n```\r\n\r\n### 方式二：本地开发调试\r\n\r\n```bash\r\ngit clone <repo-url>\r\ncd yuque-mcp-server\r\nnpm install\r\nnpm run build\r\n```\r\n\r\n然后在 `mcp.json` 中配置：\r\n\r\n```json\r\n{\r\n  \"mcpServers\": {\r\n    \"yuque-mcp\": {\r\n      \"command\": \"node\",\r\n      \"args\": [\"你的绝对路径/yuque-mcp-server/dist/index.js\"],\r\n      \"env\": {\r\n        \"YUQUE_HOST\": \"https://bd-tech.yuque.com\",\r\n        \"YUQUE_TOKEN\": \"\",\r\n        \"YUQUE_COOKIE\": \"\",\r\n        \"YUQUE_COOKIE_FILE\": \"\"\r\n      }\r\n    }\r\n  }\r\n}\r\n```\r\n\r\n### 环境变量说明\r\n\r\n| 变量名 | 必填 | 说明 |\r\n|--------|------|------|\r\n| `YUQUE_HOST` | 推荐 | 语雀域名，如 `https://bd-tech.yuque.com`。也可通过 `update_yuque_config` 或 `config.json` 配置 |\r\n| `YUQUE_TOKEN` | 可选 | 语雀个人访问令牌（需超级会员）。跟域名绑定 |\r\n| `YUQUE_COOKIE` | 可选 | 语雀登录 Cookie 字符串。跟域名绑定 |\r\n| `YUQUE_COOKIE_FILE` | 可选 | 自定义 Cookie 文件路径，默认 `~/.yuque-mcp/config.json` |\r\n\r\n**以上环境变量都可以留空。** 推荐使用本地配置文件管理凭据（即时生效，无需重启 Cursor）。\r\n\r\n### 本地配置文件\r\n\r\n位置：`~/.yuque-mcp/config.json`\r\n\r\n```json\r\n{\r\n  \"host\": \"https://bd-tech.yuque.com\",\r\n  \"cookie\": \"你的Cookie...\",\r\n  \"token\": \"\"\r\n}\r\n```\r\n\r\n三个字段都可选，填了哪个用哪个。可通过 `update_yuque_config` 工具自动管理，也可手动编辑。\r\n\r\n### 配置优先级\r\n\r\n| 配置项 | 优先级（高 → 低） |\r\n|--------|------------------|\r\n| 域名 | 工具参数 > env `YUQUE_HOST` > config.json `host` |\r\n| 认证 | env `YUQUE_TOKEN` > env `YUQUE_COOKIE` > config.json `token` > config.json `cookie` |\r\n\r\n环境变量修改需重启 Cursor；config.json 修改即时生效。\r\n\r\n## 使用示例\r\n\r\n### 下载文档\r\n\r\n> 下载这个语雀文档 https://bd-tech.yuque.com/group/book/slug\r\n\r\n自动保存到工作区下的 `yuque-downloads/` 目录。也可指定路径：\r\n\r\n> 下载到 D:\\docs 目录 https://bd-tech.yuque.com/group/book/slug\r\n\r\n### 上传（创建新文档）\r\n\r\n> 把 @xxx.md 上传到 https://bd-tech.yuque.com/group/book\r\n\r\n### 在指定目录分组下创建\r\n\r\n> 把 @xxx.md 上传到 https://bd-tech.yuque.com/group/book ，放在「互联互通」目录下\r\n\r\n### 创建子文档\r\n\r\n> 把 @xxx.md 作为子文档上传到 https://bd-tech.yuque.com/group/book/parent-slug\r\n\r\n### 更新已有文档\r\n\r\n> 用 @xxx.md 更新这个语雀文档 https://bd-tech.yuque.com/group/book/slug\r\n\r\n### 搜索知识库\r\n\r\n> 列出我的语雀知识库\r\n\r\n> 搜索包含\"充电\"的知识库\r\n\r\n### 查看目录结构\r\n\r\n> 看一下 https://bd-tech.yuque.com/group/book 的目录结构\r\n\r\n### 更新配置\r\n\r\n> 更新语雀配置，Cookie 是：lang=zh-cn; _yuque_session=xxx...\r\n\r\n### 检查连接\r\n\r\n> 检查一下语雀连接是否正常\r\n\r\n## 项目结构\r\n\r\n```\r\nyuque-mcp-server/\r\n├── package.json\r\n├── tsconfig.json\r\n├── README.md\r\n├── .npmrc\r\n├── src/\r\n│   ├── index.ts          # MCP Server 入口 + 工具注册\r\n│   ├── yuque-client.ts   # 语雀 API 封装、认证、配置管理\r\n│   └── utils.ts          # 文件操作、Markdown 清洗\r\n└── dist/                 # 编译产物\r\n```\r\n\r\n## License\r\n\r\nMIT\r\n","readmeFilename":"README.md"}