@aipper/zentao-mcp-server 0.1.12 → 0.1.14

package/.env.example

@@ -8,6 +8,9 @@ ZENTAO_PASSWORD=your_password
 # 可选：API 前缀（默认 /api.php/v1）
 # ZENTAO_API_PREFIX=/api.php/v1
 
+# 可选：默认项目 ID（直接查 /projects/{id}/bugs，不与其它项目合并）
+# ZENTAO_PROJECT_ID=15
+
 # 可选：默认产品 ID（当实例请求 bug 列表需要 product id 时使用）
 # ZENTAO_PRODUCT_ID=1
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aipper/zentao-mcp-server",
-  "version": "0.1.12",
+  "version": "0.1.14",
   "private": false,
   "type": "module",
   "description": "A minimal MCP server for ZenTao (token + focused bug workflow tools).",

package/src/index.js

@@ -82,6 +82,7 @@ function getConfigFromEnv() {
   const timeoutMs = Number(process.env.ZENTAO_HTTP_TIMEOUT_MS || "30000");
   const defaultProductId = Number(process.env.ZENTAO_PRODUCT_ID || "0") || null;
   const defaultProjectSetId = Number(process.env.ZENTAO_PROJECT_SET_ID || "0") || null;
+  const defaultProjectId = Number(process.env.ZENTAO_PROJECT_ID || "0") || null;
   const myBugsPath = String(process.env.ZENTAO_MY_BUGS_PATH || "").trim();
   const bugsFallbackPaths = String(process.env.ZENTAO_BUGS_FALLBACK_PATHS || "")
     .split(",")
@@ -104,6 +105,7 @@ function getConfigFromEnv() {
     allowInsecureHttp: ALLOW_INSECURE_HTTP,
     defaultProductId,
     defaultProjectSetId,
+    defaultProjectId,
     myBugsPath,
     bugsFallbackPaths,
     projectSetBugsPaths,
@@ -162,6 +164,7 @@ async function main() {
           limit: args.limit,
           page: args.page,
           productId: args.productId,
+          projectId: args.projectId,
           projectSetId: args.projectSetId,
           path: args.path || "/bugs",
         });
@@ -192,6 +195,7 @@ async function main() {
           limit: args.limit,
           page: args.page,
           productId: args.productId,
+          projectId: args.projectId,
           projectSetId: args.projectSetId,
           maxItems: args.maxItems,
           resolution: args.resolution || "fixed",
@@ -236,9 +240,9 @@ async function main() {
         ok: false,
         tool: rawToolName,
         message: String(err?.message || err),
-        status: err?.status ?? null,
-        hint: "If you see 'Need product id', set env ZENTAO_PRODUCT_ID or pass productId in get_my_bugs.",
-        hint2: "For project-set instances, prefer get_my_bugs with projectSetId or ZENTAO_MY_BUGS_PATH=/my/bug; list_my_projects may miss project sets without concrete projects.",
+          status: err?.status ?? null,
+          hint: "If you see 'Need product id', set env ZENTAO_PRODUCT_ID or pass productId in get_my_bugs. For project-scoped bugs, set ZENTAO_PROJECT_ID or pass projectId.",
+          hint2: "For project-set instances, prefer get_my_bugs with projectSetId or ZENTAO_MY_BUGS_PATH=/my/bug; list_my_projects may miss project sets without concrete projects.",
       };
       return toMcpTextResult(JSON.stringify(errorPayload, null, 2), { isError: true });
     }

package/src/tools.js

@@ -41,6 +41,11 @@ export const TOOLS = [
         limit: { type: "number", minimum: 1, maximum: 200, description: "Default 20, max 200" },
         page: { type: "number", minimum: 1, description: "Default 1" },
         productId: { type: "number", minimum: 1, description: "Optional product id (for instances requiring product scope)" },
+        projectId: {
+          type: "number",
+          minimum: 1,
+          description: "Optional project id. Directly query /projects/{id}/bugs, no cross-project merge.",
+        },
         projectSetId: {
           type: "number",
           minimum: 1,
@@ -100,6 +105,11 @@ export const TOOLS = [
         limit: { type: "number", minimum: 1, maximum: 200, description: "List page size, default 50" },
         page: { type: "number", minimum: 1, description: "Default 1" },
         productId: { type: "number", minimum: 1, description: "Optional product id (for instances requiring product scope)" },
+        projectId: {
+          type: "number",
+          minimum: 1,
+          description: "Optional project id. Directly query /projects/{id}/bugs, no cross-project merge.",
+        },
         projectSetId: {
           type: "number",
           minimum: 1,
@@ -196,6 +206,9 @@ export function assertToolArgs(name, args) {
     if (args.projectSetId !== undefined && (!Number.isFinite(args.projectSetId) || args.projectSetId < 1)) {
       throw new Error("get_my_bugs.projectSetId must be a number >= 1");
     }
+    if (args.projectId !== undefined && (!Number.isFinite(args.projectId) || args.projectId < 1)) {
+      throw new Error("get_my_bugs.projectId must be a number >= 1");
+    }
   }
   if (name === "get_bug_detail") {
     if (!Number.isFinite(args.id) || Number(args.id) < 1) {
@@ -232,6 +245,9 @@ export function assertToolArgs(name, args) {
     if (args.projectSetId !== undefined && (!Number.isFinite(args.projectSetId) || args.projectSetId < 1)) {
       throw new Error("batch_resolve_my_bugs.projectSetId must be a number >= 1");
     }
+    if (args.projectId !== undefined && (!Number.isFinite(args.projectId) || args.projectId < 1)) {
+      throw new Error("batch_resolve_my_bugs.projectId must be a number >= 1");
+    }
     if (args.path !== undefined) {
       if (typeof args.path !== "string") throw new Error("batch_resolve_my_bugs.path must be a string");
       if (!SAFE_BUG_LIST_PATHS.has(args.path)) {

package/src/zentao.js

@@ -95,6 +95,7 @@ function createAbortSignal(timeoutMs) {
  * @param {number} config.timeoutMs - Request timeout in milliseconds
  * @param {number} [config.defaultProductId] - Default product ID
  * @param {number} [config.defaultProjectSetId] - Default project set ID
+ * @param {number} [config.defaultProjectId] - Default project ID
  * @param {string} [config.myBugsPath] - My bugs path
  * @param {string[]} [config.bugsFallbackPaths] - Bug fallback paths
  * @param {string[]} [config.projectSetBugsPaths] - Project set bug paths
@@ -113,6 +114,7 @@ export function createZenTaoClient(config) {
     allowInsecureHttp,
     defaultProductId,
     defaultProjectSetId,
+    defaultProjectId,
     myBugsPath,
     bugsFallbackPaths,
     projectSetBugsPaths,
@@ -515,7 +517,9 @@ export function createZenTaoClient(config) {
         : cleaned.startsWith("//")
           ? new URL(`${baseProtocol}${cleaned}`)
           : cleaned.startsWith("/")
-            ? resolveAgainstDeploymentPath(cleaned)
+            ? (cleaned.includes("?") || cleaned.includes("#"))
+              ? new URL(cleaned.replace(/^\//, ""), deploymentBaseUrl)
+              : resolveAgainstDeploymentPath(cleaned)
             : resolveAgainstDeploymentPath(`/${cleaned.replace(/^\.?\//, "")}`);
       if (candidate.origin !== baseOrigin) return "";
       return candidate.toString();
@@ -748,6 +752,7 @@ export function createZenTaoClient(config) {
     limit = 20,
     page = 1,
     productId,
+    projectId,
     projectSetId,
     path = "/bugs",
   } = {}) {
@@ -755,6 +760,41 @@ export function createZenTaoClient(config) {
     const safePage = Math.max(1, Number(page) || 1);
     const dashboardScanLimit = Math.max(safeLimit, 100);
     const assignee = normalizeString(auth.account);
+    const effectiveProjectId = normalizePositiveInt(projectId) || normalizePositiveInt(defaultProjectId);
+
+    if (effectiveProjectId) {
+      const query = { limit: safeLimit, page: safePage, assignedTo: assignee, status: status || undefined };
+      try {
+        const resp = await call({ path: `/projects/${effectiveProjectId}/bugs`, method: "GET", query });
+        const bugs = parseBugsFromResponse(resp?.data);
+        const filtered = bugs.filter((bug) => matchesBugFilters(bug, { status, keyword, assignee }));
+        return {
+          total: filtered.length,
+          matched: filtered.length,
+          page: safePage,
+          limit: safeLimit,
+          projectId: effectiveProjectId,
+          assignedTo: assignee,
+          bugs: filtered,
+          raw: {
+            status: resp?.status ?? null,
+            path: `/projects/${effectiveProjectId}/bugs`,
+            triedPaths: [{
+              path: `/projects/${effectiveProjectId}/bugs`,
+              status: resp?.status ?? null,
+              total: bugs.length,
+              matched: filtered.length,
+            }],
+            scannedTotal: bugs.length,
+            paths: [{ path: `/projects/${effectiveProjectId}/bugs`, status: resp?.status ?? null, total: bugs.length, matched: filtered.length }],
+            merged: false,
+          },
+        };
+      } catch (err) {
+        throw err;
+      }
+    }
+
     const effectiveProductId = normalizePositiveInt(productId) || normalizePositiveInt(defaultProductId);
     const effectiveProjectSetId = normalizePositiveInt(projectSetId) || normalizePositiveInt(defaultProjectSetId);
     const requestedPath = normalizeBugsListPath(path);
@@ -1287,6 +1327,7 @@ export function createZenTaoClient(config) {
     limit = 50,
     page = 1,
     productId,
+    projectId,
     projectSetId,
     maxItems = 20,
     resolution = "fixed",
@@ -1302,6 +1343,7 @@ export function createZenTaoClient(config) {
       limit,
       page,
       productId,
+      projectId,
       projectSetId,
       path,
     });