@page.su/ai-blog-cli 0.1.0-beta.1

package/dist/tools/code-repos.js

@@ -0,0 +1,149 @@
+import { z } from "zod";
+import { toolReplyHelpers } from "./helpers.js";
+/**
+ * 代码仓库相关 MCP 工具：
+ * post.get_code_repo / post.upsert_code_repo / post.delete_code_repo / post.patch_code_file
+ * code_repo.list / post.link_code_repo / code_repo.get_links
+ *
+ * 设计原则：
+ *  - 工具的入参 schema 用 zod raw shape 形态
+ *  - upsert_code_repo 是幂等操作，文章已有关联仓库则更新，否则创建新仓库并关联
+ *  - 一篇文章最多关联一个仓库，一个仓库可被多篇文章共享
+ *  - code_repo.list + post.link_code_repo 让 Agent 可搜索并复用已有仓库
+ *  - tool 的返回统一打包为 { content: [{ type: "text", text: <json> }] }
+ */
+const { safe } = toolReplyHelpers;
+/** 注册全部代码仓库相关工具 */
+export function registerCodeRepoTools(server, api) {
+    // ─── post.get_code_repo ───────────────────────────────────────────────
+    server.registerTool("post.get_code_repo", {
+        title: "Get code repository",
+        description: "获取指定文章关联的代码仓库，包含所有文件的完整内容。" +
+            "一篇文章最多关联一个代码仓库，一个仓库可被多篇文章共享。" +
+            "返回的 files 数组中每项包含 path（支持文件夹层级）和 content。",
+        inputSchema: {
+            id: z.string().describe("文章 id (uuid)"),
+        },
+    }, async ({ id }) => safe(() => api.get(`/api/mcp/posts/${encodeURIComponent(id)}/code`)));
+    // ─── post.upsert_code_repo ────────────────────────────────────────────
+    server.registerTool("post.upsert_code_repo", {
+        title: "Create or update code repository",
+        description: "创建或更新文章关联的代码仓库。如果该文章已有关联仓库则更新，否则创建新仓库并关联。" +
+            "一篇文章最多关联一个仓库。files 数组中每项的 path 支持文件夹层级（如 'src/components/Button.tsx'）。" +
+            "⚠️ path 必须为相对路径，禁止以 / 开头或包含 ..。" +
+            "💡 如果想复用已有仓库而非创建新的，请先用 code_repo.list 搜索，再用 post.link_code_repo 关联。",
+        inputSchema: {
+            id: z.string().describe("文章 id (uuid)"),
+            title: z.string().max(255).optional().describe("仓库展示名称"),
+            description: z.string().optional().describe("仓库描述"),
+            defaultFilePath: z
+                .string()
+                .optional()
+                .describe("默认打开的文件路径，如 'README.md'"),
+            meta: z
+                .object({
+                branch: z.string().optional().describe("展示用分支名"),
+                license: z.string().optional().describe("展示用许可证"),
+                repoUrl: z.string().optional().describe("关联的外部仓库链接"),
+            })
+                .optional()
+                .describe("仓库元信息"),
+            files: z
+                .array(z.object({
+                path: z
+                    .string()
+                    .describe("文件相对路径，如 'src/index.ts'（禁止绝对路径或 ..）"),
+                content: z.string().describe("文件内容"),
+            }))
+                .min(1)
+                .describe("代码文件列表，至少包含一个文件"),
+        },
+    }, async ({ id, title, description, defaultFilePath, meta, files }) => safe(() => api.post(`/api/mcp/posts/${encodeURIComponent(id)}/code`, {
+        title,
+        description,
+        defaultFilePath,
+        meta,
+        files,
+    })));
+    // ─── post.delete_code_repo ────────────────────────────────────────────
+    server.registerTool("post.delete_code_repo", {
+        title: "Delete code repository",
+        description: "解除文章与代码仓库的关联。若文章是仓库的唯一所有者，则同时删除仓库。文章本身不受影响。" +
+            "💡 解除前可用 code_repo.get_links 确认是否有其他文章共享此仓库。",
+        inputSchema: {
+            id: z.string().describe("文章 id (uuid)"),
+        },
+    }, async ({ id }) => safe(() => api.delete(`/api/mcp/posts/${encodeURIComponent(id)}/code`)));
+    // ─── code_repo.list ─────────────────────────────────────────────────────
+    server.registerTool("code_repo.list", {
+        title: "List code repositories",
+        description: "列出所有代码仓库（支持搜索和分页）。" +
+            "用于发现可复用的已有仓库，避免重复创建。" +
+            "返回每个仓库的 id、标题、文件数和被关联的文章数量。",
+        inputSchema: {
+            search: z.string().optional().describe("按标题模糊搜索"),
+            page: z.number().int().min(1).optional().describe("页码，默认 1"),
+            pageSize: z
+                .number()
+                .int()
+                .min(1)
+                .max(50)
+                .optional()
+                .describe("每页条数，默认 20"),
+        },
+    }, async ({ search, page, pageSize }) => {
+        const params = new URLSearchParams();
+        if (search)
+            params.set("search", search);
+        if (page)
+            params.set("page", String(page));
+        if (pageSize)
+            params.set("pageSize", String(pageSize));
+        const qs = params.toString();
+        return safe(() => api.get(`/api/mcp/code-repos${qs ? `?${qs}` : ""}`));
+    });
+    // ─── post.link_code_repo ────────────────────────────────────────────────
+    server.registerTool("post.link_code_repo", {
+        title: "Link article to existing code repository",
+        description: "将文章关联到一个已有的代码仓库（不创建新仓库）。" +
+            "适用于系列文章共享同一个代码库的场景。" +
+            "一篇文章最多关联一个仓库，若已有关联需先解除。" +
+            "先用 code_repo.list 搜索可复用的仓库，再用此工具关联。",
+        inputSchema: {
+            id: z.string().describe("文章 id (uuid)"),
+            codeRepoId: z
+                .string()
+                .describe("要关联的仓库 id (uuid)，从 code_repo.list 获取"),
+        },
+    }, async ({ id, codeRepoId }) => safe(() => api.post(`/api/mcp/posts/${encodeURIComponent(id)}/code/link`, {
+        codeRepoId,
+    })));
+    // ─── code_repo.get_links ────────────────────────────────────────────────
+    server.registerTool("code_repo.get_links", {
+        title: "Get articles linked to a code repository",
+        description: "查看某个代码仓库被哪些文章关联。" +
+            "用于了解仓库的共享情况，避免误删正在被使用的仓库。",
+        inputSchema: {
+            repoId: z.string().describe("仓库 id (uuid)"),
+        },
+    }, async ({ repoId }) => safe(() => api.get(`/api/mcp/code-repos/${encodeURIComponent(repoId)}/links`)));
+    // ─── post.patch_code_file ─────────────────────────────────────────────
+    server.registerTool("post.patch_code_file", {
+        title: "Update a single file in code repository",
+        description: "更新代码仓库中的单个文件内容（不影响其他文件）。" +
+            "⚠️ 修改单个文件的首选方式，无需重传整个仓库。" +
+            "先用 post.get_code_repo 查看现有文件列表，修改后用此工具写回。",
+        inputSchema: {
+            id: z.string().describe("文章 id (uuid)"),
+            filePath: z
+                .string()
+                .min(1)
+                .describe("要更新的文件路径（与仓库中的 path 一致），如 'src/index.ts'"),
+            content: z.string().describe("该文件的新内容"),
+        },
+    }, async ({ id, filePath, content }) => safe(() => api.patch(`/api/mcp/posts/${encodeURIComponent(id)}/code/file`, {
+        filePath,
+        content,
+    })));
+}
+//# sourceMappingURL=code-repos.js.map

package/dist/tools/code-repos.js.map

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

package/dist/tools/comments.d.ts

@@ -0,0 +1,12 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { ApiClient } from "../api-client.js";
+/**
+ * 评论相关 MCP 工具：comment.create。
+ *
+ * 支持：
+ *  - 在指定文章下创建一级评论（仅传 postId + content）
+ *  - 回复指定评论（额外传 parentId）
+ */
+/** 注册评论相关 MCP 工具 */
+export declare function registerCommentTools(server: McpServer, api: ApiClient): void;
+//# sourceMappingURL=comments.d.ts.map

package/dist/tools/comments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"comments.d.ts","sourceRoot":"","sources":["../../src/tools/comments.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAGlD;;;;;;GAMG;AAEH,oBAAoB;AACpB,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,GAAG,IAAI,CAiG5E"}

package/dist/tools/comments.js

@@ -0,0 +1,87 @@
+import { z } from "zod";
+import { safe } from "./helpers.js";
+/**
+ * 评论相关 MCP 工具：comment.create。
+ *
+ * 支持：
+ *  - 在指定文章下创建一级评论（仅传 postId + content）
+ *  - 回复指定评论（额外传 parentId）
+ */
+/** 注册评论相关 MCP 工具 */
+export function registerCommentTools(server, api) {
+    // ─── comment.create ────────────────────────────────────────────────────
+    server.registerTool("comment.create", {
+        title: "Create comment",
+        description: "在指定文章下创建一级评论，或回复已有评论。" +
+            "创建一级评论只需传 postId + content；" +
+            "回复某条评论需额外传 parentId（被回复评论的 UUID）。" +
+            "content 支持 Markdown 格式，长度 1-5000 字符。",
+        inputSchema: {
+            postId: z.string().uuid().describe("目标文章 ID（UUID）"),
+            parentId: z
+                .string()
+                .uuid()
+                .nullable()
+                .describe("要回复的评论 ID（UUID）；创建一级评论时传 null 或不传")
+                .optional(),
+            content: z
+                .string()
+                .min(1)
+                .max(5000)
+                .describe("评论内容，支持 Markdown，1-5000 字符"),
+        },
+    }, async ({ postId, parentId, content }) => safe(() => api.post("/api/mcp/comments", {
+        postId,
+        parentId: parentId ?? null,
+        content,
+    })));
+    // ─── comment.ai_generate ──────────────────────────────────────────────
+    server.registerTool("comment.ai_generate", {
+        title: "Generate AI comment",
+        description: "使用指定的 AI Bot 对文章生成一条评论。" +
+            "可通过 botId（UUID）或 botSlug（如 tech-observer）指定机器人。" +
+            "生成的评论默认为草稿状态（需后台审核），除非 Bot 配置了自动发布或传入 autoApprove=true。" +
+            "可选传入 instruction 引导评论方向，parentId 可回复已有评论。",
+        inputSchema: {
+            botId: z
+                .string()
+                .uuid()
+                .optional()
+                .describe("Bot UUID。与 botSlug 二选一"),
+            botSlug: z
+                .string()
+                .optional()
+                .describe("Bot slug（如 tech-observer）。与 botId 二选一"),
+            postId: z.string().uuid().describe("目标文章 ID（UUID）"),
+            instruction: z
+                .string()
+                .max(500)
+                .optional()
+                .describe("额外指令，引导 AI 评论方向（可选）"),
+            parentId: z
+                .string()
+                .uuid()
+                .nullable()
+                .optional()
+                .describe("要回复的评论 ID（UUID）；对文章直接评论时不传"),
+            autoApprove: z
+                .boolean()
+                .optional()
+                .describe("是否跳过审核直接发布（覆盖 Bot 默认配置）"),
+        },
+    }, async ({ botId, botSlug, postId, instruction, parentId, autoApprove }) => safe(() => api.post("/api/mcp/ai-comments", {
+        botId,
+        botSlug,
+        postId,
+        instruction,
+        parentId: parentId ?? null,
+        autoApprove,
+    })));
+    // ─── comment.ai_list_bots ─────────────────────────────────────────────
+    server.registerTool("comment.ai_list_bots", {
+        title: "List AI bots",
+        description: "列出所有已启用的 AI 评论机器人，返回 id / slug / name / provider / model。",
+        inputSchema: {},
+    }, async () => safe(() => api.get("/api/mcp/ai-comments")));
+}
+//# sourceMappingURL=comments.js.map

package/dist/tools/comments.js.map

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

package/dist/tools/demos.d.ts

@@ -0,0 +1,5 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { ApiClient } from "../api-client.js";
+/** 注册全部 Demo 相关工具 */
+export declare function registerDemoTools(server: McpServer, api: ApiClient): void;
+//# sourceMappingURL=demos.d.ts.map

package/dist/tools/demos.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"demos.d.ts","sourceRoot":"","sources":["../../src/tools/demos.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAalD,qBAAqB;AACrB,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,GAAG,IAAI,CAsIzE"}

package/dist/tools/demos.js

@@ -0,0 +1,98 @@
+import { z } from "zod";
+import { toolReplyHelpers } from "./posts.js";
+/**
+ * Demo 相关 MCP 工具：post.list_demos / get_demo / upsert_demo / delete_demo。
+ *
+ * 设计原则：
+ *  - 工具的入参 schema 用 zod raw shape 形态
+ *  - upsert_demo 是幂等操作，按 postId+slot 匹配
+ *  - tool 的返回统一打包为 `{ content: [{ type: "text", text: <json> }] }`
+ */
+const { safe } = toolReplyHelpers;
+/** 注册全部 Demo 相关工具 */
+export function registerDemoTools(server, api) {
+    // ─── post.list_demos ─────────────────────────────────────────────────────
+    server.registerTool("post.list_demos", {
+        title: "List all demos of a post",
+        description: "列出指定文章的所有 Demo，返回每个 Demo 的 slot、title 等基本信息。",
+        inputSchema: {
+            id: z.string().describe("文章 id (uuid)"),
+        },
+    }, async ({ id }) => safe(() => api.get(`/api/mcp/posts/${encodeURIComponent(id)}/demos`)));
+    // ─── post.get_demo ───────────────────────────────────────────────────────
+    server.registerTool("post.get_demo", {
+        title: "Get demo source code",
+        description: "获取指定文章的某个 Demo 的完整源码，包括 meta 和所有 files。" +
+            "⚠️ 会一次性返回 Demo 全部文件内容。如果 Demo 较大或只需查看/修改单个文件，" +
+            "推荐改用 post.get_demo_file 按文件名读取。",
+        inputSchema: {
+            id: z.string().describe("文章 id (uuid)"),
+            slot: z.string().describe("Demo 的 slot 标识"),
+        },
+    }, async ({ id, slot }) => safe(() => api.get(`/api/mcp/posts/${encodeURIComponent(id)}/demos/${encodeURIComponent(slot)}`)));
+    // ─── post.upsert_demo ────────────────────────────────────────────────────
+    server.registerTool("post.upsert_demo", {
+        title: "Create or update a demo",
+        description: "创建或更新文章的 Demo。这是一个幂等操作：如果存在相同 postId+slot 的 Demo 则更新，否则创建新 Demo。" +
+            "⚠️ Demo 代码独立存储，文章正文通过 {{demo:slot-name}} 占位符引用。" +
+            "修改 Demo 单个文件用 post.patch_demo_file 更高效，无需重传所有文件。",
+        inputSchema: {
+            id: z.string().describe("文章 id (uuid)"),
+            slot: z
+                .string()
+                .min(1)
+                .max(128)
+                .describe("Demo 的 slot 标识，1-128 字符"),
+            title: z.string().optional().describe("Demo 标题"),
+            meta: z
+                .object({
+                tailwind: z.boolean().optional().describe("是否启用 Tailwind Play CDN"),
+                cdn: z.array(z.string()).optional().describe("外部 CDN URL 列表"),
+                height: z.number().int().optional().describe("iframe 初始高度（像素）"),
+            })
+                .optional()
+                .describe("Demo 元数据配置"),
+            files: z
+                .array(z.object({
+                name: z.string().describe("文件名（含扩展名），如 index.html"),
+                content: z.string().describe("文件内容"),
+            }))
+                .describe("Demo 的文件列表"),
+        },
+    }, async ({ id, slot, title, meta, files }) => safe(() => api.post(`/api/mcp/posts/${encodeURIComponent(id)}/demos`, { slot, title, meta, files })));
+    // ─── post.get_demo_file ─────────────────────────────────────────────────
+    server.registerTool("post.get_demo_file", {
+        title: "Read a single file from a demo",
+        description: "读取 Demo 中的单个文件内容（不加载其他文件）。" +
+            "⚠️ Demo 较大时（>5000字），优先用此工具按文件名读取，避免 post.get_demo 全量加载。" +
+            "文件名可从 post.list_demos 返回的 files 列表中获取（含每个文件的 contentLength）。",
+        inputSchema: {
+            id: z.string().describe("文章 id (uuid)"),
+            slot: z.string().describe("Demo 的 slot 标识"),
+            fileName: z.string().min(1).describe("要读取的文件名（含扩展名），如 'app.js'"),
+        },
+    }, async ({ id, slot, fileName }) => safe(() => api.get(`/api/mcp/posts/${encodeURIComponent(id)}/demos/${encodeURIComponent(slot)}/file`, { name: fileName })));
+    // ─── post.patch_demo_file ─────────────────────────────────────────────────
+    server.registerTool("post.patch_demo_file", {
+        title: "Update a single file in a demo",
+        description: "更新 Demo 中的单个文件内容（不影响其他文件）。" +
+            "⚠️ 修改 Demo 的首选方式。先用 post.get_demo_file 读取目标文件，修改后用此工具写回。" +
+            "无需重传 Demo 的其他文件。",
+        inputSchema: {
+            id: z.string().describe("文章 id (uuid)"),
+            slot: z.string().describe("Demo 的 slot 标识"),
+            fileName: z.string().min(1).describe("要更新的文件名（含扩展名），如 'app.js'"),
+            content: z.string().describe("该文件的新内容"),
+        },
+    }, async ({ id, slot, fileName, content }) => safe(() => api.patch(`/api/mcp/posts/${encodeURIComponent(id)}/demos/${encodeURIComponent(slot)}/file`, { fileName, content })));
+    // ─── post.delete_demo ────────────────────────────────────────────────────
+    server.registerTool("post.delete_demo", {
+        title: "Delete a demo",
+        description: "删除指定文章的某个 Demo。",
+        inputSchema: {
+            id: z.string().describe("文章 id (uuid)"),
+            slot: z.string().describe("Demo 的 slot 标识"),
+        },
+    }, async ({ id, slot }) => safe(() => api.delete(`/api/mcp/posts/${encodeURIComponent(id)}/demos/${encodeURIComponent(slot)}`)));
+}
+//# sourceMappingURL=demos.js.map

package/dist/tools/demos.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"demos.js","sourceRoot":"","sources":["../../src/tools/demos.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE9C;;;;;;;GAOG;AACH,MAAM,EAAE,IAAI,EAAE,GAAG,gBAAgB,CAAC;AAElC,qBAAqB;AACrB,MAAM,UAAU,iBAAiB,CAAC,MAAiB,EAAE,GAAc;IACjE,4EAA4E;IAC5E,MAAM,CAAC,YAAY,CACjB,iBAAiB,EACjB;QACE,KAAK,EAAE,0BAA0B;QACjC,WAAW,EAAE,8CAA8C;QAC3D,WAAW,EAAE;YACX,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC;SACxC;KACF,EACD,KAAK,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,kBAAkB,kBAAkB,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CACxF,CAAC;IAEF,4EAA4E;IAC5E,MAAM,CAAC,YAAY,CACjB,eAAe,EACf;QACE,KAAK,EAAE,sBAAsB;QAC7B,WAAW,EACT,yCAAyC;YACzC,+CAA+C;YAC/C,iCAAiC;QACnC,WAAW,EAAE;YACX,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC;YACvC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC;SAC5C;KACF,EACD,KAAK,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,CACrB,IAAI,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,kBAAkB,kBAAkB,CAAC,EAAE,CAAC,UAAU,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CACpG,CAAC;IAEF,4EAA4E;IAC5E,MAAM,CAAC,YAAY,CACjB,kBAAkB,EAClB;QACE,KAAK,EAAE,yBAAyB;QAChC,WAAW,EACT,kEAAkE;YAClE,iDAAiD;YACjD,kDAAkD;QACpD,WAAW,EAAE;YACX,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC;YACvC,IAAI,EAAE,CAAC;iBACJ,MAAM,EAAE;iBACR,GAAG,CAAC,CAAC,CAAC;iBACN,GAAG,CAAC,GAAG,CAAC;iBACR,QAAQ,CAAC,yBAAyB,CAAC;YACtC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC;YAChD,IAAI,EAAE,CAAC;iBACJ,MAAM,CAAC;gBACN,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wBAAwB,CAAC;gBACnE,GAAG,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC;gBAC7D,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iBAAiB,CAAC;aAChE,CAAC;iBACD,QAAQ,EAAE;iBACV,QAAQ,CAAC,YAAY,CAAC;YACzB,KAAK,EAAE,CAAC;iBACL,KAAK,CACJ,CAAC,CAAC,MAAM,CAAC;gBACP,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wBAAwB,CAAC;gBACnD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC;aACrC,CAAC,CACH;iBACA,QAAQ,CAAC,YAAY,CAAC;SAC1B;KACF,EACD,KAAK,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,CACzC,IAAI,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,kBAAkB,kBAAkB,CAAC,EAAE,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CACvG,CAAC;IAEF,2EAA2E;IAC3E,MAAM,CAAC,YAAY,CACjB,oBAAoB,EACpB;QACE,KAAK,EAAE,gCAAgC;QACvC,WAAW,EACT,4BAA4B;YAC5B,yDAAyD;YACzD,8DAA8D;QAChE,WAAW,EAAE;YACX,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC;YACvC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC;YAC3C,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,0BAA0B,CAAC;SACjE;KACF,EACD,KAAK,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,CAC/B,IAAI,CAAC,GAAG,EAAE,CACR,GAAG,CAAC,GAAG,CACL,kBAAkB,kBAAkB,CAAC,EAAE,CAAC,UAAU,kBAAkB,CAAC,IAAI,CAAC,OAAO,EACjF,EAAE,IAAI,EAAE,QAAQ,EAAE,CACnB,CACF,CACJ,CAAC;IAEF,6EAA6E;IAC7E,MAAM,CAAC,YAAY,CACjB,sBAAsB,EACtB;QACE,KAAK,EAAE,gCAAgC;QACvC,WAAW,EACT,4BAA4B;YAC5B,0DAA0D;YAC1D,kBAAkB;QACpB,WAAW,EAAE;YACX,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC;YACvC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC;YAC3C,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,0BAA0B,CAAC;YAChE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC;SACxC;KACF,EACD,KAAK,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,EAAE,CACxC,IAAI,CAAC,GAAG,EAAE,CACR,GAAG,CAAC,KAAK,CACP,kBAAkB,kBAAkB,CAAC,EAAE,CAAC,UAAU,kBAAkB,CAAC,IAAI,CAAC,OAAO,EACjF,EAAE,QAAQ,EAAE,OAAO,EAAE,CACtB,CACF,CACJ,CAAC;IAEF,4EAA4E;IAC5E,MAAM,CAAC,YAAY,CACjB,kBAAkB,EAClB;QACE,KAAK,EAAE,eAAe;QACtB,WAAW,EAAE,iBAAiB;QAC9B,WAAW,EAAE;YACX,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC;YACvC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC;SAC5C;KACF,EACD,KAAK,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,CACrB,IAAI,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,kBAAkB,kBAAkB,CAAC,EAAE,CAAC,UAAU,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CACvG,CAAC;AACJ,CAAC"}

package/dist/tools/glossary.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type ApiClient } from "../api-client.js";
+export declare function registerGlossaryTools(server: McpServer, api: ApiClient): void;
+//# sourceMappingURL=glossary.d.ts.map

package/dist/tools/glossary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"glossary.d.ts","sourceRoot":"","sources":["../../src/tools/glossary.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,EAAkB,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAC;AA4DlE,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,GAAG,IAAI,CAuG7E"}

package/dist/tools/glossary.js

@@ -0,0 +1,139 @@
+import { z } from "zod";
+import { ApiClientError } from "../api-client.js";
+/**
+ * 术语词库相关 MCP 工具：glossary.list / get / create / update / delete
+ *
+ * 独立于 post 工具，因为术语有额外的 terms/brief/autoLink 字段，
+ * 且语义上应与文章区分，AI 使用时更清晰。
+ */
+/** 术语字段 schema */
+const glossaryFieldsShape = {
+    title: z.string().min(1).describe("术语标题，必填").optional(),
+    slug: z.string().describe("术语 slug；为空时由后端自动生成").optional(),
+    status: z.enum(["draft", "published"]).describe("状态").optional(),
+    publishedAt: z.string().describe("ISO 时间字符串").optional(),
+    categoryIds: z.array(z.string().uuid()).describe("分类 id 列表").optional(),
+    tagIds: z.array(z.string().uuid()).describe("标签 id 列表").optional(),
+    excerpt: z.string().describe("摘要，最长 400 字符").optional(),
+    content: z.string().describe("Markdown 正文，术语的完整说明").optional(),
+    seoTitle: z.string().describe("SEO 标题").optional(),
+    seoDescription: z.string().describe("SEO 描述").optional(),
+    terms: z.string().describe("匹配词，多个用 | 分隔，如 'Promise|Thenable'").optional(),
+    brief: z.string().describe("简短释义（≤200字），用于 hover tooltip").optional(),
+    autoLink: z.boolean().describe("是否启用自动高亮匹配").optional(),
+};
+function toToolText(value) {
+    return {
+        content: [
+            {
+                type: "text",
+                text: typeof value === "string" ? value : JSON.stringify(value, null, 2),
+            },
+        ],
+    };
+}
+function toToolError(error) {
+    let text;
+    if (error instanceof ApiClientError) {
+        const lines = [`HTTP ${error.status}: ${error.message}`];
+        if (error.issues !== undefined) {
+            lines.push("Validation issues:");
+            lines.push(JSON.stringify(error.issues, null, 2));
+        }
+        text = lines.join("\n");
+    }
+    else if (error instanceof Error) {
+        text = error.message;
+    }
+    else {
+        text = String(error);
+    }
+    return {
+        content: [{ type: "text", text }],
+        isError: true,
+    };
+}
+export function registerGlossaryTools(server, api) {
+    // ── glossary.list ──
+    server.tool("glossary_list", "列出术语词库中的术语。支持按状态筛选和关键词搜索。", {
+        status: z.enum(["draft", "published"]).describe("按状态筛选").optional(),
+        search: z.string().describe("搜索关键词（匹配术语名/匹配词）").optional(),
+        page: z.number().int().positive().describe("页码，默认 1").optional(),
+        pageSize: z.number().int().positive().max(100).describe("每页数量，默认 20").optional(),
+    }, async ({ status, search, page, pageSize }) => {
+        try {
+            const params = new URLSearchParams();
+            if (status)
+                params.set("status", status);
+            if (search)
+                params.set("search", search);
+            if (page)
+                params.set("page", String(page));
+            if (pageSize)
+                params.set("pageSize", String(pageSize));
+            const result = await api.get(`/api/mcp/glossary?action=list&${params.toString()}`);
+            return toToolText(result);
+        }
+        catch (error) {
+            return toToolError(error);
+        }
+    });
+    // ── glossary.get ──
+    server.tool("glossary_get", "获取一个术语的完整可编辑数据，包含匹配词、简短释义、Markdown 正文等。", {
+        id: z.string().uuid().describe("术语 id (uuid)"),
+    }, async ({ id }) => {
+        try {
+            const result = await api.get(`/api/mcp/glossary?action=get&id=${id}`);
+            return toToolText(result);
+        }
+        catch (error) {
+            return toToolError(error);
+        }
+    });
+    // ── glossary.create ──
+    server.tool("glossary_create", "创建一个新的术语条目。terms（匹配词）和 brief（简短释义）为术语特有必填字段。", glossaryFieldsShape, async (params) => {
+        try {
+            const result = await api.post("/api/mcp/glossary", {
+                action: "create",
+                data: params,
+            });
+            return toToolText(result);
+        }
+        catch (error) {
+            return toToolError(error);
+        }
+    });
+    // ── glossary.update ──
+    server.tool("glossary_update", "更新一个已有的术语条目。需要传入完整字段。", {
+        id: z.string().uuid().describe("术语 id (uuid)"),
+        ...glossaryFieldsShape,
+    }, async ({ id, ...data }) => {
+        try {
+            const result = await api.post("/api/mcp/glossary", {
+                action: "update",
+                id,
+                data,
+            });
+            return toToolText(result);
+        }
+        catch (error) {
+            return toToolError(error);
+        }
+    });
+    // ── glossary.delete ──
+    server.tool("glossary_delete", "永久删除一个术语条目。请谨慎使用。", {
+        id: z.string().uuid().describe("术语 id (uuid)"),
+    }, async ({ id }) => {
+        try {
+            const result = await api.post("/api/mcp/glossary", {
+                action: "delete",
+                id,
+            });
+            return toToolText(result);
+        }
+        catch (error) {
+            return toToolError(error);
+        }
+    });
+}
+//# sourceMappingURL=glossary.js.map

package/dist/tools/glossary.js.map

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

package/dist/tools/helpers.d.ts

@@ -0,0 +1,44 @@
+/**
+ * MCP 工具通用 helper 函数
+ * 统一处理工具返回值和错误格式，避免各工具文件重复定义
+ */
+/**
+ * 将数据转换为 MCP 工具的标准文本响应格式
+ */
+export declare function toToolText(value: unknown): {
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+};
+/**
+ * 将错误转换为 MCP 工具的标准错误响应格式
+ * 对 ApiClientError 做特殊处理，输出 HTTP 状态码和校验问题
+ */
+export declare function toToolError(error: unknown): {
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    isError: true;
+};
+/**
+ * 安全执行异步函数，自动捕获错误并转换为标准错误格式
+ * 用于简化工具函数的错误处理逻辑
+ */
+export declare function safe<T>(fn: () => Promise<T>): Promise<{
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    isError?: true;
+}>;
+/**
+ * 导出统一的 helper 对象，方便导入使用
+ */
+export declare const toolReplyHelpers: {
+    toToolText: typeof toToolText;
+    toToolError: typeof toToolError;
+    safe: typeof safe;
+};
+//# sourceMappingURL=helpers.d.ts.map

package/dist/tools/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/tools/helpers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAS7F;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG;IAC3C,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,OAAO,EAAE,IAAI,CAAC;CACf,CAkBA;AAED;;;GAGG;AACH,wBAAsB,IAAI,CAAC,CAAC,EAC1B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAAC,OAAO,CAAC,EAAE,IAAI,CAAA;CAAE,CAAC,CAO7E;AAED;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;CAI5B,CAAC"}