yuque-ai-mcp 2.9.0 → 2.10.0

package/README.md

@@ -4,7 +4,7 @@
 
 <h1 align="center">yuque-ai-mcp</h1>
 <p align="center">
-  <b>67 fine-grained MCP tools for the full Yuque OpenAPI</b>
+  <b>68 fine-grained MCP tools for the full Yuque OpenAPI</b>
 </p>
 
 <p align="center">
@@ -19,11 +19,11 @@
 
 ---
 
-A full-featured Yuque (语雀) MCP Server built on the [Model Context Protocol](https://modelcontextprotocol.io/). Provides 67 fine-grained tools across 16 domains — every Yuque OpenAPI endpoint as a dedicated tool.
+A full-featured Yuque (语雀) MCP Server built on the [Model Context Protocol](https://modelcontextprotocol.io/). Provides 68 fine-grained tools across 16 domains — every Yuque OpenAPI endpoint as a dedicated tool.
 
 ## Why
 
-- **19 → 67 tools** — 3x more coverage than the official [yuque-mcp-server](https://github.com/yuque/yuque-mcp-server)
+- **19 → 68 tools** — 3x more coverage than the official [yuque-mcp-server](https://github.com/yuque/yuque-mcp-server)
 - **Dual transport** — stdio + HTTP SSE, shared registry, zero downtime on reload
 - **Modular architecture** — 15 domains, barrel exports, single source of truth registry
 - **Full API coverage** — group, recycle, upload, statistics, versions, boards — all the missing pieces
@@ -76,9 +76,9 @@ npm run dev:http       # HTTP SSE mode (http://localhost:3099)
 | **rss** | 3 | Source list, fetch + dedup + save, schedule analysis |
 | **crawler** | 4 | Fetch, CSS extract, dedup save, schedule analysis |
 | **kv** | 4 | Get, set, delete, list — incremental sharding, 250KB/doc limit |
-| **Total** | **67** | |
+| **Total** | **68** | |
 
-### All 67 Tools
+### All 68 Tools
 
 | Tool | Domain | Description |
 |------|--------|-------------|
@@ -88,6 +88,7 @@ npm run dev:http       # HTTP SSE mode (http://localhost:3099)
 | `yuque_search` | search | 通用搜索文档/知识库 |
 | `yuque_rag_search` | search | RAG 检索增强搜索 + 自动获取文档内容 |
 | `yuque_web_search` | search | Cookie 态 Web 搜索，返回完整文档对象 + 精确总数 + 高亮摘要 |
+| `yuque_web_delete_doc` | doc | Cookie 态删除文档（v2 被限流时的备用通道，移入回收站） |
 | `yuque_get_group_users` | group | 获取团队成员列表 |
 | `yuque_update_group_user` | group | 变更团队成员角色 |
 | `yuque_delete_group_user` | group | 删除团队成员 |
@@ -152,7 +153,7 @@ See [SKILL.md](SKILL.md) or [yuque-ai-skills](https://github.com/yehuoshun/yuque
 
 | Feature | Official yuque-mcp-server | yuque-ai-mcp |
 |---------|--------------------------|--------------|
-| Tools | 19 | **67** |
+| Tools | 19 | **68** |
 | Granularity | Coarse | **Fine-grained** (1 tool / endpoint) |
 | Group, Recycle, Upload, Statistics | ❌ | ✅ |
 | Versions, Diff, Cross-book Copy | ❌ | ✅ |

package/SKILL.md

@@ -1,6 +1,6 @@
 # yuque-ai-mcp
 
-语雀全功能 MCP Server，67 个工具 / 16 个域。当用户提到「语雀」「yuque」「知识库」「文档」「团队」等关键词时触发。
+语雀全功能 MCP Server，68 个工具 / 16 个域。当用户提到「语雀」「yuque」「知识库」「文档」「团队」等关键词时触发。
 
 ## 触发场景
 
@@ -135,13 +135,14 @@
 | `yuque_get_book_stacks` | 获取知识库分组（书架）列表 |
 | `yuque_get_editor_center` | 获取个人编辑中心全景数据 |
 
-### web_doc（4 工具，Cookie 态）
+### web_doc（5 工具，Cookie 态）
 | 工具 | 说明 |
 |------|------|
 | `yuque_web_get_doc` | Cookie 态读文档正文（含 body/content），不受会员过期限流 |
 | `yuque_web_list_docs` | Cookie 态列文档列表，更丰富的字段 |
 | `yuque_web_list_repos` | Cookie 态列知识库列表，含权限信息 |
 | `yuque_web_get_toc` | Cookie 态获取知识库目录 TOC |
+| `yuque_web_delete_doc` | Cookie 态删除文档（移入回收站，v2 被限流时的备用通道） |
 
 ### kv（4 工具）
 | 工具 | 说明 |

package/dist/web-doc/delete-doc.d.ts

@@ -0,0 +1,14 @@
+/**
+ * web-doc/delete-doc — Cookie 态删除文档
+ *
+ * 端点：DELETE /api/docs/{id}?book_id={book_id}（Web API，Cookie 认证）
+ * 职责：删除指定文档（移入回收站），v2 删除被限流时作为替代通道
+ *
+ * 相比 v2 delete_doc 的优势：
+ *   - 不走 Token，不受会员过期限流（429）
+ *   - 与 web get/list 同一认证体系，v2 挂掉时仍可删
+ *
+ * ⚠️ 删除不可逆（移入回收站，可恢复）。
+ */
+import type { McpTool } from "../common/types.js";
+export declare const webDocDelete: McpTool;

package/dist/web-doc/delete-doc.js

@@ -0,0 +1,79 @@
+/**
+ * web-doc/delete-doc — Cookie 态删除文档
+ *
+ * 端点：DELETE /api/docs/{id}?book_id={book_id}（Web API，Cookie 认证）
+ * 职责：删除指定文档（移入回收站），v2 删除被限流时作为替代通道
+ *
+ * 相比 v2 delete_doc 的优势：
+ *   - 不走 Token，不受会员过期限流（429）
+ *   - 与 web get/list 同一认证体系，v2 挂掉时仍可删
+ *
+ * ⚠️ 删除不可逆（移入回收站，可恢复）。
+ */
+import { isErrorResult } from "../common/api-client.js";
+import { webRequest } from "../common/web-request.js";
+import { check, requiredString, optionalBoolean } from "../common/validate.js";
+import { confirmationParam, checkConfirmation } from "../common/errors.js";
+const DOC_REFERER = "https://www.yuque.com/";
+export const webDocDelete = {
+    name: "yuque_web_delete_doc",
+    description: "Cookie-based: Delete a document (moves to recycle bin). " +
+        "DELETE /api/docs/{id}?book_id={book_id}. " +
+        "No membership required, alternative to v2 delete_doc when Token is rate-limited/expired. " +
+        "⚠️ Requires confirm='DELETE'. " +
+        "详见 references/api/doc_api.md",
+    inputSchema: {
+        type: "object",
+        properties: {
+            id: { type: "string", description: "Document ID (numeric, required)" },
+            book_id: { type: "string", description: "Repository ID (numeric, required)" },
+            confirm: confirmationParam.confirm,
+            raw: { type: "boolean", description: "Return raw full JSON (default false, returns trimmed fields)" },
+        },
+        required: ["id", "book_id", "confirm"],
+    },
+    async handler(args) {
+        // @validate
+        const __v = check(requiredString(args?.id, "id"), requiredString(args?.book_id, "book_id"), optionalBoolean(args?.raw, "raw"));
+        if (__v)
+            return __v;
+        const confirmed = checkConfirmation(args);
+        if (confirmed)
+            return confirmed;
+        const id = Number(args?.id);
+        const bookId = Number(args?.book_id);
+        if (!id || !bookId) {
+            return {
+                content: [{ type: "text", text: JSON.stringify({ error: "id 和 book_id 必须为有效数字 / id and book_id must be valid numbers" }, null, 2) }],
+                isError: true,
+            };
+        }
+        const raw = args?.raw;
+        const url = `https://www.yuque.com/api/docs/${id}?book_id=${bookId}`;
+        const result = await webRequest(url, { method: "DELETE", referer: DOC_REFERER });
+        if (isErrorResult(result))
+            return result;
+        const data = result?.data;
+        if (!data) {
+            return {
+                content: [{ type: "text", text: JSON.stringify({ error: "NO_DATA" }, null, 2) }],
+                isError: true,
+            };
+        }
+        if (raw) {
+            return {
+                content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
+            };
+        }
+        return {
+            content: [{ type: "text", text: JSON.stringify({
+                        id: data.id,
+                        title: data.title,
+                        slug: data.slug,
+                        deleted: true,
+                        note: "移入回收站，可通过 yuque_list_recycles 查看 / yuque_restore_recycle 恢复",
+                    }, null, 2) }],
+        };
+    },
+};
+//# sourceMappingURL=delete-doc.js.map

package/dist/web-doc/delete-doc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete-doc.js","sourceRoot":"","sources":["../../src/web-doc/delete-doc.ts"],"names":[],"mappings":"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"}

package/dist/web-doc/index.d.ts

@@ -2,5 +2,6 @@ export { webDocGet } from "./get-doc.js";
 export { webDocList } from "./list-docs.js";
 export { webRepoList } from "./list-repos.js";
 export { webTocGet } from "./get-toc.js";
+export { webDocDelete } from "./delete-doc.js";
 import type { McpTool } from "../common/types.js";
 export declare const webDocTools: McpTool[];

package/dist/web-doc/index.js

@@ -2,9 +2,11 @@ export { webDocGet } from "./get-doc.js";
 export { webDocList } from "./list-docs.js";
 export { webRepoList } from "./list-repos.js";
 export { webTocGet } from "./get-toc.js";
+export { webDocDelete } from "./delete-doc.js";
 import { webDocGet } from "./get-doc.js";
 import { webDocList } from "./list-docs.js";
 import { webRepoList } from "./list-repos.js";
 import { webTocGet } from "./get-toc.js";
-export const webDocTools = [webDocGet, webDocList, webRepoList, webTocGet];
+import { webDocDelete } from "./delete-doc.js";
+export const webDocTools = [webDocGet, webDocList, webRepoList, webTocGet, webDocDelete];
 //# sourceMappingURL=index.js.map

package/dist/web-doc/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/web-doc/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC,MAAM,CAAC,MAAM,WAAW,GAAc,CAAC,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,SAAS,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/web-doc/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C,MAAM,CAAC,MAAM,WAAW,GAAc,CAAC,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,SAAS,EAAE,YAAY,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "yuque-ai-mcp",
-  "version": "2.9.0",
+  "version": "2.10.0",
   "description": "Full-featured Yuque MCP Server — 62 fine-grained tools covering the entire Yuque OpenAPI",
   "type": "module",
   "main": "dist/index.js",