@dannyvan/zentao-mcp 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 dannyvan
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,62 @@
+# @dannyvan/zentao-mcp
+
+禅道（ZenTao）**MCP + CLI**，直连 REST API（`api.php/v1`）。只做 Bug：读详情 / 列表 / 搜索，写评论与状态流转。写操作默认 dry-run。
+
+## 安装
+
+```bash
+npx -y @dannyvan/zentao-mcp
+```
+
+发布到 npm 之前，可在本仓 `npm install && npm run build` 后用 `node dist/index.js`。
+
+## 认证
+
+| 变量 | 说明 |
+|---|---|
+| `ZENTAO_URL` | **必填**，禅道地址（不含 `/api.php/v1`） |
+| `ZENTAO_ACCOUNT` + `ZENTAO_PASSWORD` | 推荐：自动换取并刷新 token |
+| `ZENTAO_TOKEN` | 或直接给现成 token（会过期） |
+
+## MCP
+
+```json
+{
+  "mcpServers": {
+    "zentao": {
+      "command": "npx",
+      "args": ["-y", "@dannyvan/zentao-mcp"],
+      "env": {
+        "ZENTAO_URL": "https://<禅道域名>/zentao",
+        "ZENTAO_ACCOUNT": "<账号>",
+        "ZENTAO_PASSWORD": "<密码>"
+      }
+    }
+  }
+}
+```
+
+**Tools**
+
+- 读：`zentao_get_bug` / `zentao_list_bugs` / `zentao_search_bugs`
+- 写：`zentao_comment_bug`（v1 不支持，会报错）/ `resolve` `close` `activate` `confirm` `assign`（默认 dry-run，带 `confirm=true` 才提交）
+
+`zentao_list_bugs` 的 `total` 禅道可能不准，以翻页实际列出为准。
+
+## CLI
+
+```bash
+npx -y @dannyvan/zentao-mcp help
+npx -y @dannyvan/zentao-mcp get-bug 123
+npx -y @dannyvan/zentao-mcp list-bugs --product 1 --limit 50
+npx -y @dannyvan/zentao-mcp assign-bug 123 --assigned-to someone
+npx -y @dannyvan/zentao-mcp assign-bug 123 --assigned-to someone --confirm
+```
+
+无参数或 `serve` 时走 MCP stdio。输出 JSON；出错写 stderr，退出码非 0。
+
+## 安全
+
+- 写操作默认 dry-run（MCP：`confirm=true`；CLI：`--confirm`）
+- 批量改状态请串行逐条，不要并行
+- 写操作在禅道可见

package/dist/cli.d.ts

@@ -0,0 +1 @@
+export declare function runCli(argv: string[]): Promise<void>;

package/dist/cli.js

@@ -0,0 +1,156 @@
+/**
+ * CLI 门面 —— 与 MCP 共用同一套 ZentaoClient 与同一套安全约束。
+ *
+ * 写操作默认 dry-run，必须显式 --confirm 才真正提交。
+ * 输出一律 JSON；出错时 JSON 写 stderr，退出码非 0。
+ */
+import { clientFromEnv, formatZentaoError } from "./zentao-client.js";
+const USAGE = `zentao-mcp —— 禅道 CLI / MCP 双门面
+
+用法:
+  zentao-mcp                          以 MCP server 启动（stdio，默认）
+  zentao-mcp serve                    同上，显式写法
+  zentao-mcp <命令> [参数]             CLI 模式
+
+读命令（无副作用）:
+  get-bug <id>                               查单个 Bug
+  list-bugs --product <id> [--status <s>] [--limit <n>]
+  search-bugs --product <id> --keyword <kw>
+
+写命令（默认仅预览，加 --confirm 才提交）:
+  resolve-bug  <id> --resolution <r> [--comment <c>] [--confirm]
+  close-bug    <id> [--comment <c>] [--confirm]
+  activate-bug <id> [--assigned-to <a>] [--comment <c>] [--confirm]
+  confirm-bug  <id> [--assigned-to <a>] [--confirm]
+  assign-bug   <id> --assigned-to <a> [--comment <c>] [--confirm]
+
+认证（环境变量）:
+  ZENTAO_URL                                 必填，禅道地址
+  ZENTAO_ACCOUNT + ZENTAO_PASSWORD           推荐，自动换取并刷新 token
+  ZENTAO_TOKEN                               临时/测试，会过期
+
+⚠️ 写操作在禅道可见。批量改状态请串行逐条执行，不要并行。`;
+function parseArgs(argv) {
+    const positional = [];
+    const flags = {};
+    for (let i = 0; i < argv.length; i++) {
+        const a = argv[i];
+        if (!a.startsWith("--")) {
+            positional.push(a);
+            continue;
+        }
+        const key = a.slice(2);
+        const next = argv[i + 1];
+        if (next === undefined || next.startsWith("--")) {
+            flags[key] = true;
+        }
+        else {
+            flags[key] = next;
+            i++;
+        }
+    }
+    return { positional, flags };
+}
+function out(data) {
+    console.log(JSON.stringify(data, null, 2));
+}
+function fail(message) {
+    console.error(JSON.stringify({ ok: false, error: message }, null, 2));
+    process.exit(1);
+}
+function requireId(positional) {
+    const id = Number(positional[0]);
+    if (!Number.isInteger(id) || id <= 0)
+        fail("缺少或非法的 Bug ID（应为正整数）");
+    return id;
+}
+function requireFlag(flags, name) {
+    const v = flags[name];
+    if (typeof v !== "string" || !v)
+        fail(`缺少必填参数 --${name}`);
+    return v;
+}
+async function highRisk(client, id, confirm, preview, exec) {
+    const bug = await client.getBug(id);
+    if (!confirm) {
+        out({
+            ok: true,
+            dryRun: true,
+            preview: preview(bug),
+            bug: { id: bug.id, title: bug.title, status: bug.status },
+            hint: "确认无误后加 --confirm 重新执行以真正提交。⚠️ 该操作在禅道可见。",
+        });
+        return;
+    }
+    out({ ok: true, dryRun: false, result: await exec() });
+}
+export async function runCli(argv) {
+    const [command, ...rest] = argv;
+    if (!command || command === "help" || command === "--help" || command === "-h") {
+        console.log(USAGE);
+        return;
+    }
+    const { positional, flags } = parseArgs(rest);
+    const confirm = flags.confirm === true || flags.confirm === "true";
+    const client = clientFromEnv();
+    try {
+        switch (command) {
+            case "get-bug":
+                out({ ok: true, bug: await client.getBug(requireId(positional)) });
+                return;
+            case "list-bugs": {
+                const product = Number(requireFlag(flags, "product"));
+                const params = { limit: Number(flags.limit ?? 50) };
+                if (typeof flags.status === "string")
+                    params.status = flags.status;
+                out({ ok: true, result: await client.listProductBugs(product, params) });
+                return;
+            }
+            case "search-bugs": {
+                const product = Number(requireFlag(flags, "product"));
+                const keyword = requireFlag(flags, "keyword");
+                out({ ok: true, result: await client.listProductBugs(product, { keyword, limit: Number(flags.limit ?? 50) }) });
+                return;
+            }
+            case "resolve-bug": {
+                const id = requireId(positional);
+                const resolution = requireFlag(flags, "resolution");
+                const comment = typeof flags.comment === "string" ? flags.comment : undefined;
+                await highRisk(client, id, confirm, (b) => `将把 Bug #${id}「${b.title}」标记为已解决（resolution=${resolution}），当前状态 ${b.status}`, () => client.resolveBug(id, { resolution, comment }));
+                return;
+            }
+            case "close-bug": {
+                const id = requireId(positional);
+                const comment = typeof flags.comment === "string" ? flags.comment : undefined;
+                await highRisk(client, id, confirm, (b) => `将关闭 Bug #${id}「${b.title}」，当前状态 ${b.status}`, () => client.closeBug(id, { comment }));
+                return;
+            }
+            case "activate-bug": {
+                const id = requireId(positional);
+                const assignedTo = typeof flags["assigned-to"] === "string" ? flags["assigned-to"] : undefined;
+                const comment = typeof flags.comment === "string" ? flags.comment : undefined;
+                await highRisk(client, id, confirm, (b) => `将激活 Bug #${id}「${b.title}」，当前状态 ${b.status}${assignedTo ? `，指派给 ${assignedTo}` : ""}`, () => client.activateBug(id, { comment, assignedTo }));
+                return;
+            }
+            case "confirm-bug": {
+                const id = requireId(positional);
+                const assignedTo = typeof flags["assigned-to"] === "string" ? flags["assigned-to"] : undefined;
+                await highRisk(client, id, confirm, (b) => `将确认 Bug #${id}「${b.title}」，当前状态 ${b.status}${assignedTo ? `，指派给 ${assignedTo}` : ""}`, () => client.confirmBug(id, { assignedTo }));
+                return;
+            }
+            case "assign-bug": {
+                const id = requireId(positional);
+                const assignedTo = requireFlag(flags, "assigned-to");
+                const comment = typeof flags.comment === "string" ? flags.comment : undefined;
+                await highRisk(client, id, confirm, (b) => `将把 Bug #${id}「${b.title}」指派给 ${assignedTo}，当前状态 ${b.status}`, () => client.assignBug(id, { assignedTo, comment }));
+                return;
+            }
+            default:
+                fail(`未知命令：${command}\n\n${USAGE}`);
+        }
+    }
+    catch (e) {
+        fail(formatZentaoError(e));
+    }
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/constants.d.ts

@@ -0,0 +1,7 @@
+/** 共享常量 */
+/** 单次响应字符上限，超出则截断并提示分页。 */
+export declare const CHARACTER_LIMIT = 25000;
+/** 解决方案枚举（禅道 bug resolution）。 */
+export declare const RESOLUTIONS: readonly ["bydesign", "duplicate", "external", "fixed", "notrepro", "postponed", "willnotfix", "tostory"];
+/** bug 状态枚举。 */
+export declare const BUG_STATUSES: readonly ["active", "resolved", "closed"];

package/dist/constants.js

@@ -0,0 +1,17 @@
+/** 共享常量 */
+/** 单次响应字符上限，超出则截断并提示分页。 */
+export const CHARACTER_LIMIT = 25000;
+/** 解决方案枚举（禅道 bug resolution）。 */
+export const RESOLUTIONS = [
+    "bydesign", // 设计如此
+    "duplicate", // 重复 bug
+    "external", // 外部原因
+    "fixed", // 已解决
+    "notrepro", // 无法重现
+    "postponed", // 延期处理
+    "willnotfix", // 不予解决
+    "tostory", // 转为需求
+];
+/** bug 状态枚举。 */
+export const BUG_STATUSES = ["active", "resolved", "closed"];
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,WAAW;AAEX,2BAA2B;AAC3B,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,CAAC;AAErC,iCAAiC;AACjC,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,UAAU,EAAE,OAAO;IACnB,WAAW,EAAE,SAAS;IACtB,UAAU,EAAE,OAAO;IACnB,OAAO,EAAE,MAAM;IACf,UAAU,EAAE,OAAO;IACnB,WAAW,EAAE,OAAO;IACpB,YAAY,EAAE,OAAO;IACrB,SAAS,EAAE,OAAO;CACV,CAAC;AAEX,gBAAgB;AAChB,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,QAAQ,EAAE,UAAU,EAAE,QAAQ,CAAU,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,62 @@
+#!/usr/bin/env node
+/**
+ * @dannyvan/zentao-mcp
+ *
+ * 禅道 MCP + CLI，直连 REST API（api.php/v1）。
+ * 读：get_bug / list_bugs / search_bugs
+ * 写：comment_bug（v1 不支持，会报错）、resolve/close/activate/confirm/assign（默认 dry-run）
+ *
+ * 认证（环境变量）：
+ *   ZENTAO_URL       禅道地址，必填
+ *   ZENTAO_ACCOUNT   账号（推荐）
+ *   ZENTAO_PASSWORD  密码（推荐）
+ *   ZENTAO_TOKEN     或直接给现成 token（临时/测试，会过期）
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { clientFromEnv } from "./zentao-client.js";
+import { registerReadTools } from "./tools/read.js";
+import { registerWriteTools } from "./tools/write.js";
+import { runCli } from "./cli.js";
+function assertUrl() {
+    if (!process.env.ZENTAO_URL?.trim()) {
+        console.error("ERROR: 缺少 ZENTAO_URL。请设置为禅道地址，例如 https://example.com/zentao");
+        process.exit(1);
+    }
+}
+function assertAuth() {
+    const hasToken = !!process.env.ZENTAO_TOKEN;
+    const hasUserPass = !!(process.env.ZENTAO_ACCOUNT && process.env.ZENTAO_PASSWORD);
+    if (!hasToken && !hasUserPass) {
+        console.error("ERROR: 缺少认证。请设置 ZENTAO_TOKEN，或同时设置 ZENTAO_ACCOUNT 与 ZENTAO_PASSWORD。");
+        process.exit(1);
+    }
+}
+async function serve() {
+    assertUrl();
+    assertAuth();
+    const server = new McpServer({ name: "zentao-mcp", version: "0.1.0" });
+    const client = clientFromEnv();
+    registerReadTools(server, client);
+    registerWriteTools(server, client);
+    await server.connect(new StdioServerTransport());
+    console.error("zentao-mcp running via stdio");
+}
+async function main() {
+    const argv = process.argv.slice(2);
+    if (argv.length === 0 || argv[0] === "serve") {
+        await serve();
+        return;
+    }
+    const needsAuth = !["help", "--help", "-h"].includes(argv[0]);
+    if (needsAuth) {
+        assertUrl();
+        assertAuth();
+    }
+    await runCli(argv);
+}
+main().catch((error) => {
+    console.error("Fatal:", error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,SAAS,SAAS;IAChB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,EAAE,EAAE,CAAC;QACpC,OAAO,CAAC,KAAK,CAAC,6DAA6D,CAAC,CAAC;QAC7E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,SAAS,UAAU;IACjB,MAAM,QAAQ,GAAG,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC;IAC5C,MAAM,WAAW,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;IAClF,IAAI,CAAC,QAAQ,IAAI,CAAC,WAAW,EAAE,CAAC;QAC9B,OAAO,CAAC,KAAK,CACX,sEAAsE,CACvE,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,KAAK,UAAU,KAAK;IAClB,SAAS,EAAE,CAAC;IACZ,UAAU,EAAE,CAAC;IACb,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;IACvE,MAAM,MAAM,GAAG,aAAa,EAAE,CAAC;IAC/B,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,kBAAkB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,oBAAoB,EAAE,CAAC,CAAC;IACjD,OAAO,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAC;AAChD,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACnC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,OAAO,EAAE,CAAC;QAC7C,MAAM,KAAK,EAAE,CAAC;QACd,OAAO;IACT,CAAC;IACD,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9D,IAAI,SAAS,EAAE,CAAC;QACd,SAAS,EAAE,CAAC;QACZ,UAAU,EAAE,CAAC;IACf,CAAC;IACD,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;AACrB,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAC/B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/tools/read.d.ts

@@ -0,0 +1,4 @@
+/** 读 tools：查 bug 详情、列产品 bug、搜索。全部 readOnlyHint。 */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { ZentaoClient } from "../zentao-client.js";
+export declare function registerReadTools(server: McpServer, client: ZentaoClient): void;

package/dist/tools/read.js

@@ -0,0 +1,184 @@
+import { z } from "zod";
+import { formatZentaoError } from "../zentao-client.js";
+import { CHARACTER_LIMIT } from "../constants.js";
+function pickAccount(v) {
+    if (!v)
+        return "";
+    if (typeof v === "object")
+        return v.account || v.realname || "";
+    return String(v);
+}
+function pickRealname(v) {
+    if (!v)
+        return "";
+    if (typeof v === "object")
+        return v.realname || v.account || "";
+    return String(v);
+}
+function stripHtml(html) {
+    return html
+        .replace(/<[^>]+>/g, "\n")
+        .replace(/&nbsp;/g, " ")
+        .replace(/&amp;/g, "&")
+        .replace(/[ \t]+/g, " ")
+        .replace(/\n\s*\n+/g, "\n")
+        .trim();
+}
+function slimBug(bug, includeSteps = false) {
+    return {
+        id: bug.id,
+        title: bug.title,
+        status: bug.status,
+        severity: bug.severity,
+        pri: bug.pri,
+        product: bug.product,
+        branch: bug.branch,
+        assignedTo: pickAccount(bug.assignedTo),
+        assignedToName: pickRealname(bug.assignedTo),
+        openedBy: pickAccount(bug.openedBy),
+        openedByName: pickRealname(bug.openedBy),
+        openedDate: bug.openedDate,
+        resolution: bug.resolution || "",
+        resolvedBy: pickAccount(bug.resolvedBy),
+        ...(includeSteps ? { steps: stripHtml(String(bug.steps || "")) } : {}),
+    };
+}
+function jsonResult(obj) {
+    let text = JSON.stringify(obj, null, 2);
+    if (text.length > CHARACTER_LIMIT) {
+        text = text.slice(0, CHARACTER_LIMIT) + "\n…(已截断，请用分页/过滤缩小范围)";
+    }
+    return { content: [{ type: "text", text }], structuredContent: obj };
+}
+function errResult(e) {
+    return { content: [{ type: "text", text: formatZentaoError(e) }], isError: true };
+}
+export function registerReadTools(server, client) {
+    server.registerTool("zentao_get_bug", {
+        title: "获取禅道 Bug 详情",
+        description: `按 ID 获取单条禅道 Bug 的完整信息，含重现步骤(steps)。
+
+Args:
+  - id (number): Bug 的数字 ID
+  - include_steps (boolean): 是否包含 steps 纯文本，默认 true
+
+Returns: { id, title, status, severity, pri, product, assignedTo, openedBy, openedDate, resolution, steps? }
+
+只读，不修改任何数据。`,
+        inputSchema: {
+            id: z.number().int().positive().describe("Bug 的数字 ID"),
+            include_steps: z.boolean().default(true).describe("是否包含重现步骤纯文本"),
+        },
+        annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true },
+    }, async ({ id, include_steps }) => {
+        try {
+            const bug = await client.getBug(id);
+            return jsonResult(slimBug(bug, include_steps));
+        }
+        catch (e) {
+            return errResult(e);
+        }
+    });
+    server.registerTool("zentao_list_bugs", {
+        title: "列出产品下的 Bug",
+        description: `列出某产品下的 Bug，服务端分页。可选按状态/指派人过滤。
+
+Args:
+  - product (number): 产品 ID
+  - limit (number): 每页条数 1-200，默认 50
+  - page (number): 页码，从 1 开始，默认 1
+  - status ('active'|'resolved'|'closed'): 可选
+  - assigned_to (string): 可选，按指派人 account 过滤当前页
+
+Returns: { product, page, limit, total, count, bugs: [...], has_more }
+
+只读。禅道返回的 total 可能不准（随 limit 变），以翻页实际列出为准。`,
+        inputSchema: {
+            product: z.number().int().positive().describe("产品 ID"),
+            limit: z.number().int().min(1).max(200).default(50).describe("每页条数"),
+            page: z.number().int().min(1).default(1).describe("页码，从 1 开始"),
+            status: z
+                .enum(["all", "active", "resolved", "closed"])
+                .default("all")
+                .describe("按状态过滤，默认 all。注意默认不传时禅道只返回很窄的子集"),
+            assigned_to: z.string().optional().describe("按指派人 account 过滤"),
+        },
+        annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true },
+    }, async ({ product, limit, page, status, assigned_to }) => {
+        try {
+            const params = { status, limit, page };
+            if (assigned_to)
+                params.assignedTo = assigned_to;
+            const data = await client.listProductBugs(product, params);
+            let bugs = Array.isArray(data?.bugs) ? data.bugs : [];
+            if (assigned_to)
+                bugs = bugs.filter((b) => pickAccount(b.assignedTo) === assigned_to);
+            const total = Number(data?.total ?? bugs.length);
+            const out = {
+                product,
+                page,
+                limit,
+                total,
+                count: bugs.length,
+                bugs: bugs.map((b) => slimBug(b, false)),
+                has_more: total > page * limit,
+                ...(total > page * limit ? { next_page: page + 1 } : {}),
+            };
+            return jsonResult(out);
+        }
+        catch (e) {
+            return errResult(e);
+        }
+    });
+    server.registerTool("zentao_search_bugs", {
+        title: "搜索产品下的 Bug",
+        description: `在某产品下按关键词搜索 Bug（匹配标题与 steps）。底层拉取分页列表后客户端过滤。
+
+Args:
+  - product (number): 产品 ID
+  - keyword (string): 关键词
+  - scan_limit (number): 最多扫描多少条(分页累加)，默认 200，上限 1000
+
+Returns: { product, keyword, scanned, matched, bugs: [...] }
+
+只读。命中范围受 scan_limit 限制，必要时调大。`,
+        inputSchema: {
+            product: z.number().int().positive().describe("产品 ID"),
+            keyword: z.string().min(1).describe("搜索关键词"),
+            scan_limit: z.number().int().min(1).max(1000).default(200).describe("最多扫描条数"),
+        },
+        annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true },
+    }, async ({ product, keyword, scan_limit }) => {
+        try {
+            const pageSize = 100;
+            const collected = [];
+            let page = 1;
+            let total = Infinity;
+            while (collected.length < scan_limit && (page - 1) * pageSize < total) {
+                const data = await client.listProductBugs(product, { status: "all", limit: pageSize, page });
+                total = Number(data?.total ?? 0);
+                const bugs = Array.isArray(data?.bugs) ? data.bugs : [];
+                if (bugs.length === 0)
+                    break;
+                collected.push(...bugs);
+                page += 1;
+            }
+            const scanned = collected.slice(0, scan_limit);
+            const kw = keyword.toLowerCase();
+            const matched = scanned.filter((b) => String(b.title || "").toLowerCase().includes(kw) ||
+                stripHtml(String(b.steps || "")).toLowerCase().includes(kw));
+            return jsonResult({
+                product,
+                keyword,
+                scanned: scanned.length,
+                total_in_product: total === Infinity ? scanned.length : total,
+                matched: matched.length,
+                bugs: matched.map((b) => slimBug(b, false)),
+            });
+        }
+        catch (e) {
+            return errResult(e);
+        }
+    });
+}
+//# sourceMappingURL=read.js.map

package/dist/tools/read.js.map

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

package/dist/tools/write.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 写 tools。分级把关：
+ *  - 评论：v1 不支持，调用即报错
+ *  - 状态流转：默认 dry-run，带 confirm=true 才真写
+ * 写操作在禅道可见。
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { ZentaoClient } from "../zentao-client.js";
+export declare function registerWriteTools(server: McpServer, client: ZentaoClient): void;

package/dist/tools/write.js

@@ -0,0 +1,144 @@
+import { z } from "zod";
+import { formatZentaoError } from "../zentao-client.js";
+import { RESOLUTIONS } from "../constants.js";
+function errResult(e) {
+    return { content: [{ type: "text", text: formatZentaoError(e) }], isError: true };
+}
+function okResult(text, structured) {
+    return { content: [{ type: "text", text }], structuredContent: structured };
+}
+const HIGH_RISK = {
+    readOnlyHint: false,
+    destructiveHint: true,
+    idempotentHint: false,
+    openWorldHint: true,
+};
+async function highRiskOp(client, id, confirm, previewLine, exec, okLine) {
+    const bug = await client.getBug(id);
+    const preview = previewLine(bug);
+    if (!confirm) {
+        return okResult(`[预览·未执行]\n${preview}\n\n确认无误后带 confirm=true 再次调用以真正提交。⚠️ 该操作在禅道可见。`, { dryRun: true, bug: { id: bug.id, title: bug.title, status: bug.status }, preview });
+    }
+    const result = await exec();
+    return okResult(okLine, { dryRun: false, result });
+}
+export function registerWriteTools(server, client) {
+    server.registerTool("zentao_comment_bug", {
+        title: "给 Bug 加备注（禅道 v1 REST 不支持，会报错）",
+        description: `⚠️ 禅道 v1 REST API **不支持**为 Bug 添加独立备注（实测：editBug 的 comment 字段被静默丢弃，
+且无 /comment 动作端点）。调用本工具会**直接返回错误**，不会假装成功。
+如需加备注：请在禅道 Web UI 手工操作，或改用旧版 session API（?m=action&f=comment）。
+Args: id (number), comment (string)`,
+        inputSchema: {
+            id: z.number().int().positive().describe("Bug ID"),
+            comment: z.string().min(1).describe("备注内容"),
+        },
+        annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true },
+    }, async ({ id, comment }) => {
+        try {
+            const result = await client.commentBug(id, comment);
+            return okResult(`✅ 已给 Bug #${id} 添加备注。`, { dryRun: false, result });
+        }
+        catch (e) {
+            return errResult(e);
+        }
+    });
+    server.registerTool("zentao_resolve_bug", {
+        title: "解决 Bug（状态流转）",
+        description: `把 Bug 标记为已解决。高风险：默认只预览，带 confirm=true 才真正提交。
+Args: id, resolution(${RESOLUTIONS.join("/")}), resolvedBuild?(默认 trunk), comment?, confirm(默认 false)`,
+        inputSchema: {
+            id: z.number().int().positive().describe("Bug ID"),
+            resolution: z
+                .enum(RESOLUTIONS)
+                .describe("解决方案：fixed/postponed/willnotfix/duplicate/external/notrepro/bydesign/tostory"),
+            resolvedBuild: z.string().optional().describe("解决版本，默认 trunk"),
+            comment: z.string().optional().describe("备注"),
+            confirm: z.boolean().default(false).describe("false=仅预览；true=真正提交"),
+        },
+        annotations: HIGH_RISK,
+    }, async ({ id, resolution, resolvedBuild, comment, confirm }) => {
+        try {
+            return await highRiskOp(client, id, confirm, (b) => `解决 Bug #${id}「${b.title}」：${b.status} → resolved，resolution=${resolution}，build=${resolvedBuild ?? "trunk"}${comment ? `，备注：${comment}` : ""}`, () => client.resolveBug(id, { resolution, resolvedBuild: resolvedBuild ?? "trunk", comment }), `✅ 已解决 Bug #${id}（resolution=${resolution}）。`);
+        }
+        catch (e) {
+            return errResult(e);
+        }
+    });
+    server.registerTool("zentao_close_bug", {
+        title: "关闭 Bug（状态流转）",
+        description: `关闭一个已解决的 Bug。高风险：默认预览，confirm=true 才执行。
+Args: id, comment?, confirm(默认 false)`,
+        inputSchema: {
+            id: z.number().int().positive().describe("Bug ID"),
+            comment: z.string().optional().describe("备注"),
+            confirm: z.boolean().default(false).describe("false=仅预览；true=真正提交"),
+        },
+        annotations: HIGH_RISK,
+    }, async ({ id, comment, confirm }) => {
+        try {
+            return await highRiskOp(client, id, confirm, (b) => `关闭 Bug #${id}「${b.title}」：${b.status} → closed${comment ? `，备注：${comment}` : ""}`, () => client.closeBug(id, { comment }), `✅ 已关闭 Bug #${id}。`);
+        }
+        catch (e) {
+            return errResult(e);
+        }
+    });
+    server.registerTool("zentao_activate_bug", {
+        title: "激活 Bug（状态流转）",
+        description: `重新激活一个已解决/关闭的 Bug。高风险：默认预览，confirm=true 才执行。
+Args: id, assignedTo?(重新指派给谁), comment?, confirm(默认 false)`,
+        inputSchema: {
+            id: z.number().int().positive().describe("Bug ID"),
+            assignedTo: z.string().optional().describe("重新指派给的 account"),
+            comment: z.string().optional().describe("备注"),
+            confirm: z.boolean().default(false).describe("false=仅预览；true=真正提交"),
+        },
+        annotations: HIGH_RISK,
+    }, async ({ id, assignedTo, comment, confirm }) => {
+        try {
+            return await highRiskOp(client, id, confirm, (b) => `激活 Bug #${id}「${b.title}」：${b.status} → active${assignedTo ? `，指派给 ${assignedTo}` : ""}${comment ? `，备注：${comment}` : ""}`, () => client.activateBug(id, { assignedTo, comment }), `✅ 已激活 Bug #${id}。`);
+        }
+        catch (e) {
+            return errResult(e);
+        }
+    });
+    server.registerTool("zentao_confirm_bug", {
+        title: "确认 Bug（状态流转）",
+        description: `确认一个 Bug（is_confirmed=1）。高风险：默认预览，confirm=true 才执行。
+Args: id, assignedTo?, confirm(默认 false)`,
+        inputSchema: {
+            id: z.number().int().positive().describe("Bug ID"),
+            assignedTo: z.string().optional().describe("确认后指派给的 account"),
+            confirm: z.boolean().default(false).describe("false=仅预览；true=真正提交"),
+        },
+        annotations: HIGH_RISK,
+    }, async ({ id, assignedTo, confirm }) => {
+        try {
+            return await highRiskOp(client, id, confirm, (b) => `确认 Bug #${id}「${b.title}」${assignedTo ? `，指派给 ${assignedTo}` : ""}`, () => client.confirmBug(id, { assignedTo }), `✅ 已确认 Bug #${id}。`);
+        }
+        catch (e) {
+            return errResult(e);
+        }
+    });
+    server.registerTool("zentao_assign_bug", {
+        title: "指派 Bug（状态流转）",
+        description: `把 Bug 指派给某人（走 PUT /bugs/{id} editBug）。高风险：默认预览，confirm=true 才执行。
+⚠️ 禅道 v1 REST 无独立指派端点，comment 无法经此记录（会被丢弃），仅指派本身生效。
+Args: id, assignedTo(account), comment?(不生效), confirm(默认 false)`,
+        inputSchema: {
+            id: z.number().int().positive().describe("Bug ID"),
+            assignedTo: z.string().min(1).describe("指派给的 account"),
+            comment: z.string().optional().describe("备注"),
+            confirm: z.boolean().default(false).describe("false=仅预览；true=真正提交"),
+        },
+        annotations: HIGH_RISK,
+    }, async ({ id, assignedTo, comment, confirm }) => {
+        try {
+            return await highRiskOp(client, id, confirm, (b) => `指派 Bug #${id}「${b.title}」给 ${assignedTo}（原指派 ${b.assignedTo?.account ?? b.assignedTo ?? "—"}）${comment ? `，备注：${comment}` : ""}`, () => client.assignBug(id, { assignedTo, comment }), `✅ 已把 Bug #${id} 指派给 ${assignedTo}。`);
+        }
+        catch (e) {
+            return errResult(e);
+        }
+    });
+}
+//# sourceMappingURL=write.js.map

package/dist/tools/write.js.map

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

package/dist/zentao-client.d.ts

@@ -0,0 +1,46 @@
+export interface ZentaoConfig {
+    baseUrl: string;
+    account?: string;
+    password?: string;
+    /** 直接复用的现成 token（跳过 account/password 换取）。 */
+    token?: string;
+}
+/** 把任意错误转成对 agent 友好、可操作的中文消息。 */
+export declare function formatZentaoError(error: unknown): string;
+export declare class ZentaoClient {
+    private http;
+    private token;
+    private readonly account?;
+    private readonly password?;
+    constructor(cfg: ZentaoConfig);
+    private ensureToken;
+    request<T = any>(method: "GET" | "POST" | "PUT" | "DELETE", endpoint: string, data?: unknown, params?: Record<string, unknown>, _retried?: boolean): Promise<T>;
+    getBug(id: number): Promise<any>;
+    listProductBugs(productId: number, params: Record<string, unknown>): Promise<any>;
+    resolveBug(id: number, body: {
+        resolution: string;
+        resolvedBuild?: string;
+        comment?: string;
+    }): Promise<any>;
+    closeBug(id: number, body: {
+        comment?: string;
+    }): Promise<any>;
+    activateBug(id: number, body: {
+        comment?: string;
+        assignedTo?: string;
+    }): Promise<any>;
+    confirmBug(id: number, body: {
+        assignedTo?: string;
+    }): Promise<any>;
+    /** 指派：PUT /bugs/{id}。v1 无独立指派端点，comment 无法经此记录。 */
+    assignBug(id: number, body: {
+        assignedTo: string;
+        comment?: string;
+    }): Promise<any>;
+    /**
+     * 加备注：v1 REST 不支持独立备注（editBug 的 comment 被静默丢弃，无 /comment 端点）。
+     * 直接抛错，避免返回假成功。
+     */
+    commentBug(_id: number, _comment: string): never;
+}
+export declare function clientFromEnv(): ZentaoClient;

package/dist/zentao-client.js

@@ -0,0 +1,140 @@
+/**
+ * 禅道 REST API 客户端。
+ *
+ * 直连 `{baseUrl}/api.php/v1`。
+ * 认证：优先用 ZENTAO_TOKEN，否则用 account+password 调 `POST /tokens`，
+ * 缓存并在 401 时自动刷新一次。
+ */
+import axios, { AxiosError } from "axios";
+/** 把任意错误转成对 agent 友好、可操作的中文消息。 */
+export function formatZentaoError(error) {
+    if (axios.isAxiosError(error)) {
+        const ax = error;
+        if (ax.response) {
+            const status = ax.response.status;
+            const body = ax.response.data;
+            const apiMsg = typeof body === "object" && body && "error" in body
+                ? String(body.error)
+                : typeof body === "string"
+                    ? body.slice(0, 200)
+                    : "";
+            switch (status) {
+                case 401:
+                    return `Error 401：认证失败或 token 失效。检查 ZENTAO_ACCOUNT/ZENTAO_PASSWORD 是否正确。${apiMsg}`;
+                case 403:
+                    return `Error 403：无权限。当前禅道账号对该资源没有操作权限。${apiMsg}`;
+                case 404:
+                    return `Error 404：对象不存在。请检查 bug/产品 ID 是否正确。${apiMsg}`;
+                case 422:
+                    return `Error 422：参数校验失败。${apiMsg || "检查必填字段（如 resolution）是否齐全。"}`;
+                default:
+                    return `Error ${status}：请求失败。${apiMsg}`;
+            }
+        }
+        if (ax.code === "ECONNABORTED")
+            return "Error：请求超时，请重试或检查网络。";
+        return `Error：网络错误 ${ax.code ?? ""} ${ax.message}`;
+    }
+    return `Error：${error instanceof Error ? error.message : String(error)}`;
+}
+export class ZentaoClient {
+    http;
+    token;
+    account;
+    password;
+    constructor(cfg) {
+        const baseUrl = cfg.baseUrl.replace(/\/$/, "");
+        this.account = cfg.account;
+        this.password = cfg.password;
+        this.token = cfg.token ?? null;
+        this.http = axios.create({
+            baseURL: `${baseUrl}/api.php/v1`,
+            timeout: 30000,
+            maxRedirects: 5,
+            headers: { "Content-Type": "application/json", Accept: "application/json" },
+            validateStatus: (s) => s >= 200 && s < 500,
+        });
+    }
+    async ensureToken() {
+        if (this.token)
+            return this.token;
+        if (!this.account || !this.password) {
+            throw new Error("缺少认证：请设置 ZENTAO_TOKEN，或同时设置 ZENTAO_ACCOUNT 与 ZENTAO_PASSWORD。");
+        }
+        const resp = await this.http.post("/tokens", {
+            account: this.account,
+            password: this.password,
+        });
+        const token = resp.data?.token;
+        if (!token) {
+            throw new Error(`换取 token 失败：${resp.data?.error ?? JSON.stringify(resp.data)}`);
+        }
+        this.token = token;
+        return token;
+    }
+    async request(method, endpoint, data, params, _retried = false) {
+        const token = await this.ensureToken();
+        const resp = await this.http.request({
+            method,
+            url: endpoint,
+            data,
+            params,
+            headers: { Token: token },
+        });
+        const status = resp.status;
+        if (status === 401 && !_retried && this.account && this.password) {
+            this.token = null;
+            return this.request(method, endpoint, data, params, true);
+        }
+        if (status >= 400) {
+            const err = new AxiosError(`ZenTao API ${status}`, String(status), undefined, undefined, { status, data: resp.data, statusText: resp.statusText, headers: resp.headers, config: resp.config });
+            throw err;
+        }
+        return resp.data;
+    }
+    getBug(id) {
+        return this.request("GET", `/bugs/${id}`);
+    }
+    listProductBugs(productId, params) {
+        return this.request("GET", `/products/${productId}/bugs`, undefined, params);
+    }
+    // 禅道 v1 REST 是精选端点集，不是通用 `{module}/{id}/{action}` 动作路由。
+    // 实测 `/bugs/{id}/assignto` 一类子路由会 404；指派走 PUT /bugs/{id}（字段合并，未传字段不清空）。
+    // resolve/close/activate/confirm 仍走动作子路由；若目标实例 404，改走 PUT 并先在测试单上验证必填字段。
+    resolveBug(id, body) {
+        return this.request("POST", `/bugs/${id}/resolve`, body);
+    }
+    closeBug(id, body) {
+        return this.request("POST", `/bugs/${id}/close`, body);
+    }
+    activateBug(id, body) {
+        return this.request("POST", `/bugs/${id}/activate`, body);
+    }
+    confirmBug(id, body) {
+        return this.request("POST", `/bugs/${id}/confirm`, body);
+    }
+    /** 指派：PUT /bugs/{id}。v1 无独立指派端点，comment 无法经此记录。 */
+    assignBug(id, body) {
+        return this.request("PUT", `/bugs/${id}`, { assignedTo: body.assignedTo });
+    }
+    /**
+     * 加备注：v1 REST 不支持独立备注（editBug 的 comment 被静默丢弃，无 /comment 端点）。
+     * 直接抛错，避免返回假成功。
+     */
+    commentBug(_id, _comment) {
+        throw new Error("禅道 v1 REST API 不支持为 Bug 添加独立备注/评论（editBug 的 comment 字段被静默丢弃，且无 /comment 动作端点）。请在禅道 Web UI 手工添加备注，或改用旧版 session API（?m=action&f=comment）。");
+    }
+}
+export function clientFromEnv() {
+    const baseUrl = process.env.ZENTAO_URL?.replace(/\/$/, "") ?? "";
+    if (!baseUrl) {
+        throw new Error("缺少 ZENTAO_URL。请设置为禅道地址，例如 https://example.com/zentao");
+    }
+    return new ZentaoClient({
+        baseUrl,
+        account: process.env.ZENTAO_ACCOUNT,
+        password: process.env.ZENTAO_PASSWORD,
+        token: process.env.ZENTAO_TOKEN,
+    });
+}
+//# sourceMappingURL=zentao-client.js.map

package/dist/zentao-client.js.map

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

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@dannyvan/zentao-mcp",
+  "version": "0.1.0",
+  "description": "禅道 MCP + CLI，直连 REST API v1。只做 Bug，写操作默认 dry-run。",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "zentao-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/dannyvan/zentao-mcp.git"
+  },
+  "bugs": {
+    "url": "https://github.com/dannyvan/zentao-mcp/issues"
+  },
+  "homepage": "https://github.com/dannyvan/zentao-mcp#readme",
+  "license": "MIT",
+  "keywords": [
+    "mcp",
+    "zentao",
+    "bug"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "prepublishOnly": "npm run build"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.6.1",
+    "axios": "^1.7.9",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "typescript": "^5.7.2"
+  }
+}