yuque-ai-mcp 2.12.1 → 2.13.0

package/README.md

@@ -4,7 +4,7 @@
 
 <h1 align="center">yuque-ai-mcp</h1>
 <p align="center">
-  <b>69 fine-grained MCP tools for the full Yuque OpenAPI</b>
+  <b>73 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 69 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 73 fine-grained tools across 16 domains — every Yuque OpenAPI endpoint as a dedicated tool.
 
 ## Why
 
-- **19 → 69 tools** — 3x more coverage than the official [yuque-mcp-server](https://github.com/yuque/yuque-mcp-server)
+- **19 → 73 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** | **69** | |
+| **Total** | **73** | |
 
-### All 69 Tools
+### All 73 Tools
 
 | Tool | Domain | Description |
 |------|--------|-------------|
@@ -89,6 +89,7 @@ npm run dev:http       # HTTP SSE mode (http://localhost:3099)
 | `yuque_rag_search` | search | RAG 检索增强搜索 + 自动获取文档内容 |
 | `yuque_web_search` | search | Cookie 态 Web 搜索，返回完整文档对象 + 精确总数 + 高亮摘要 |
 | `yuque_web_delete_doc` | doc | Cookie 态删除文档（v2 被限流时的备用通道，移入回收站） |
+| `yuque_web_copy_catalog_node` | doc | Cookie 态跨库复制目录节点（服务端重传附件，保留文件卡片） |
 | `yuque_get_group_users` | group | 获取团队成员列表 |
 | `yuque_update_group_user` | group | 变更团队成员角色 |
 | `yuque_delete_group_user` | group | 删除团队成员 |

package/dist/web-doc/copy-catalog-node.d.ts

@@ -0,0 +1,16 @@
+/**
+ * web-doc/copy-catalog-node — Cookie 态复制目录节点（跨库复制，服务端重传附件）
+ *
+ * 端点：PUT /api/catalog_nodes/copy（Web API，Cookie 认证）
+ * 职责：将目录节点（文档/目录）复制到目标目录/目标知识库下。
+ *
+ * 相比 move：
+ *   - 源节点保留，目标库生成副本
+ *   - 附件（文件/图片卡片）由服务端重新上传到目标库，卡片引用正确
+ *   - 这是唯一能跨库保留文件卡片 (ne-card-file) 的途径
+ *
+ * 注意：node_uuid 必须是 web 目录 (/api/catalog_nodes) 里的节点 uuid，
+ *   v2 TOC (/api/v2/repos/:id/toc) 的 uuid 可能对不上（两份数据不一致时）。
+ */
+import type { McpTool } from "../common/types.js";
+export declare const webCopyCatalogNode: McpTool;

package/dist/web-doc/copy-catalog-node.js

@@ -0,0 +1,121 @@
+/**
+ * web-doc/copy-catalog-node — Cookie 态复制目录节点（跨库复制，服务端重传附件）
+ *
+ * 端点：PUT /api/catalog_nodes/copy（Web API，Cookie 认证）
+ * 职责：将目录节点（文档/目录）复制到目标目录/目标知识库下。
+ *
+ * 相比 move：
+ *   - 源节点保留，目标库生成副本
+ *   - 附件（文件/图片卡片）由服务端重新上传到目标库，卡片引用正确
+ *   - 这是唯一能跨库保留文件卡片 (ne-card-file) 的途径
+ *
+ * 注意：node_uuid 必须是 web 目录 (/api/catalog_nodes) 里的节点 uuid，
+ *   v2 TOC (/api/v2/repos/:id/toc) 的 uuid 可能对不上（两份数据不一致时）。
+ */
+import { isErrorResult } from "../common/api-client.js";
+import { webRequest } from "../common/web-request.js";
+import { check, requiredString, optionalString, optionalBoolean } from "../common/validate.js";
+const COPY_REFERER = "https://www.yuque.com/";
+export const webCopyCatalogNode = {
+    name: "yuque_web_copy_catalog_node",
+    description: "Cookie-based: Copy a catalog node (doc or dir) to a target catalog node / target repo, server-side with attachment re-upload. " +
+        "PUT /api/catalog_nodes/copy. " +
+        "The source node is kept; a copy is created in the target repo and attachments re-uploaded there (preserves file cards). " +
+        "node_uuid must be from the web catalog (/api/catalog_nodes), not the v2 TOC. " +
+        "详见 references/api/catalog_api.md",
+    inputSchema: {
+        type: "object",
+        properties: {
+            book_id: {
+                type: "string",
+                description: "Source repository ID (numeric, required). The repo the node currently lives in.",
+            },
+            node_uuid: {
+                type: "string",
+                description: "Source catalog node UUID to copy (required). Must exist in the web catalog (/api/catalog_nodes).",
+            },
+            target_book_id: {
+                type: "string",
+                description: "Target repository ID (numeric, required). The repo to copy into.",
+            },
+            target_uuid: {
+                type: "string",
+                description: "Target catalog node UUID to copy into. Leave empty / null to copy to the root of the target repo.",
+            },
+            action: {
+                type: "string",
+                description: "Copy action. Default 'prependChild'. Common values: prependChild (as first child), appendChild (as last child).",
+            },
+            with_children: {
+                type: "boolean",
+                description: "Copy the whole subtree (all descendant nodes) together. Default false.",
+            },
+            insert_to_catalog: {
+                type: "boolean",
+                description: "Whether to insert into the catalog/TOC. Default true.",
+            },
+        },
+        required: ["book_id", "node_uuid", "target_book_id"],
+    },
+    async handler(args) {
+        // @validate
+        const __v = check(requiredString(args?.book_id, "book_id"), requiredString(args?.node_uuid, "node_uuid"), requiredString(args?.target_book_id, "target_book_id"), optionalString(args?.target_uuid, "target_uuid"), optionalString(args?.action, "action"), optionalBoolean(args?.with_children, "with_children"), optionalBoolean(args?.insert_to_catalog, "insert_to_catalog"));
+        if (__v)
+            return __v;
+        const bookId = Number(args?.book_id);
+        const targetBookId = Number(args?.target_book_id);
+        if (!bookId || !targetBookId) {
+            return {
+                content: [{ type: "text", text: JSON.stringify({ error: "book_id 和 target_book_id 必须为有效数字 / book_id and target_book_id must be valid numbers" }, null, 2) }],
+                isError: true,
+            };
+        }
+        // target_uuid 留空 → null（复制到目标库根目录）
+        const targetUuid = args?.target_uuid?.trim() || null;
+        const body = {
+            book_id: bookId,
+            node_uuid: args.node_uuid,
+            target_uuid: targetUuid,
+            action: args?.action?.trim() || "prependChild",
+            target_book_id: targetBookId,
+            with_children: args?.with_children ?? false,
+            insert_to_catalog: args?.insert_to_catalog ?? true,
+        };
+        const url = "https://www.yuque.com/api/catalog_nodes/copy";
+        const result = await webRequest(url, {
+            method: "PUT",
+            body,
+            referer: COPY_REFERER,
+        });
+        if (isErrorResult(result))
+            return result;
+        // copy 返回 { meta: { docIds: [...] }, data: [...] }
+        let newDocIds = [];
+        try {
+            const r = result;
+            if (Array.isArray(r?.meta?.docIds))
+                newDocIds = r.meta.docIds.map((x) => Number(x)).filter(Boolean);
+            else if (Array.isArray(r?.data)) {
+                const ids = r.data.map((n) => n?.doc_id).filter((x) => x !== undefined && x !== null && x !== "");
+                newDocIds = ids.map((x) => Number(x)).filter(Boolean);
+            }
+        }
+        catch {
+            newDocIds = [];
+        }
+        return {
+            content: [{ type: "text", text: JSON.stringify({
+                        success: true,
+                        book_id: bookId,
+                        target_book_id: targetBookId,
+                        node_uuid: args.node_uuid,
+                        target_uuid: targetUuid,
+                        action: body.action,
+                        with_children: body.with_children,
+                        new_doc_ids: newDocIds,
+                        message: "成功复制目录节点到目标知识库（附件已服务端重传） / Successfully copied catalog node (attachments re-uploaded)",
+                    }, null, 2) }],
+        };
+    },
+};
+//# sourceMappingURL=copy-catalog-node.js.map

package/dist/web-doc/copy-catalog-node.js.map

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

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

@@ -5,5 +5,6 @@ export { webTocGet } from "./get-toc.js";
 export { webDocDelete } from "./delete-doc.js";
 export { webBatchMoveCatalogNodes } from "./batch-move-catalog-nodes.js";
 export { webMoveCatalogNode } from "./move-catalog-node.js";
+export { webCopyCatalogNode } from "./copy-catalog-node.js";
 import type { McpTool } from "../common/types.js";
 export declare const webDocTools: McpTool[];

package/dist/web-doc/index.js

@@ -5,6 +5,7 @@ export { webTocGet } from "./get-toc.js";
 export { webDocDelete } from "./delete-doc.js";
 export { webBatchMoveCatalogNodes } from "./batch-move-catalog-nodes.js";
 export { webMoveCatalogNode } from "./move-catalog-node.js";
+export { webCopyCatalogNode } from "./copy-catalog-node.js";
 import { webDocGet } from "./get-doc.js";
 import { webDocList } from "./list-docs.js";
 import { webRepoList } from "./list-repos.js";
@@ -12,5 +13,6 @@ import { webTocGet } from "./get-toc.js";
 import { webDocDelete } from "./delete-doc.js";
 import { webBatchMoveCatalogNodes } from "./batch-move-catalog-nodes.js";
 import { webMoveCatalogNode } from "./move-catalog-node.js";
-export const webDocTools = [webDocGet, webDocList, webRepoList, webTocGet, webDocDelete, webBatchMoveCatalogNodes, webMoveCatalogNode];
+import { webCopyCatalogNode } from "./copy-catalog-node.js";
+export const webDocTools = [webDocGet, webDocList, webRepoList, webTocGet, webDocDelete, webBatchMoveCatalogNodes, webMoveCatalogNode, webCopyCatalogNode];
 //# 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,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,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,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAE5D,MAAM,CAAC,MAAM,WAAW,GAAc,CAAC,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,SAAS,EAAE,YAAY,EAAE,wBAAwB,EAAE,kBAAkB,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,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,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,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAE5D,MAAM,CAAC,MAAM,WAAW,GAAc,CAAC,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,SAAS,EAAE,YAAY,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,kBAAkB,CAAC,CAAC"}

package/package.json

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