@leeguoo/zentao-mcp 0.2.2 → 0.3.1

package/README.md

@@ -19,10 +19,10 @@ MCP server for ZenTao RESTful APIs (products + bugs).
       "args": [
         "-y",
         "@leeguoo/zentao-mcp",
-        "--stdio",
         "--zentao-url=https://zentao.example.com/zentao",
         "--zentao-account=leo",
-        "--zentao-password=***"
+        "--zentao-password=***",
+        "--stdio"
       ]
     }
   }
@@ -41,10 +41,10 @@ command = "npx"
 args = [
   "-y",
   "@leeguoo/zentao-mcp",
-  "--stdio",
   "--zentao-url=https://zentao.example.com/zentao",
   "--zentao-account=leo",
-  "--zentao-password=***"
+  "--zentao-password=***",
+  "--stdio"
 ]
 ```
 
@@ -92,11 +92,12 @@ If you prefer to use environment variables instead of CLI args, you can configur
 
 ## Tools
 
-The MCP server provides three tools that can be triggered by natural language in Cursor:
+The MCP server provides four tools that can be triggered by natural language in Cursor:
 
 - **`zentao_products_list`** - List all products
 - **`zentao_bugs_list`** - List bugs for a specific product
 - **`zentao_bugs_stats`** - Get bug statistics across products
+- **`zentao_bugs_mine`** - List my bugs by assignment or creator
 
 ### Usage Examples
 
@@ -107,6 +108,8 @@ After configuring the MCP server in Cursor, you can use natural language to inte
 - "List bugs for product 1"
 - "Show me bugs"
 - "What's the bug statistics?"
+- "Show my bugs"
+- "List bugs assigned to me"
 - "View bugs in product 2"
 
 **Chinese (中文):**
@@ -115,11 +118,14 @@ After configuring the MCP server in Cursor, you can use natural language to inte
 - "bug统计"
 - "显示所有产品"
 - "查看产品2的问题"
+- "我的bug"
+- "分配给我的bug"
 
 The AI will automatically:
 1. Use `zentao_products_list` to get product IDs when needed
 2. Use `zentao_bugs_list` when you ask to see bugs
 3. Use `zentao_bugs_stats` when you ask for statistics or overview
+4. Use `zentao_bugs_mine` when you ask for your own bugs
 
 ### Tool Parameters
 
@@ -148,6 +154,16 @@ The AI will automatically:
 }
 ```
 
+**zentao_bugs_mine:**
+```json
+{
+  "scope": "assigned",
+  "includeZero": false,
+  "includeDetails": true,
+  "maxItems": 50
+}
+```
+
 ## Local Development
 
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@leeguoo/zentao-mcp",
-  "version": "0.2.2",
+  "version": "0.3.1",
   "description": "MCP server for ZenTao RESTful APIs",
   "keywords": [
     "zentao",

package/src/index.js

@@ -50,6 +50,35 @@ function normalizeError(message, payload) {
   return { status: 0, msg: message || "error", result: payload ?? [] };
 }
 
+function normalizeAccountValue(value) {
+  return String(value || "").trim().toLowerCase();
+}
+
+function extractAccounts(value) {
+  if (value === undefined || value === null) return [];
+  if (typeof value === "string" || typeof value === "number") {
+    const normalized = normalizeAccountValue(value);
+    return normalized ? [normalized] : [];
+  }
+  if (Array.isArray(value)) {
+    return value.flatMap((item) => extractAccounts(item));
+  }
+  if (typeof value === "object") {
+    const candidates = [];
+    if (value.account) candidates.push(...extractAccounts(value.account));
+    if (value.realname) candidates.push(...extractAccounts(value.realname));
+    if (value.name) candidates.push(...extractAccounts(value.name));
+    if (value.user) candidates.push(...extractAccounts(value.user));
+    return candidates.filter(Boolean);
+  }
+  return [];
+}
+
+function matchesAccount(value, matchAccount) {
+  const candidates = extractAccounts(value);
+  return candidates.includes(matchAccount);
+}
+
 class ZentaoClient {
   constructor({ baseUrl, account, password }) {
     this.baseUrl = normalizeBaseUrl(baseUrl);
@@ -156,6 +185,49 @@ class ZentaoClient {
     return normalizeResult(payload);
   }
 
+  async fetchAllBugsForProduct({ product, perPage, maxItems }) {
+    const bugs = [];
+    let page = 1;
+    let total = null;
+    const pageSize = toInt(perPage, 100);
+    const cap = toInt(maxItems, 0);
+
+    while (true) {
+      const payload = await this.request({
+        method: "GET",
+        path: "/api.php/v1/bugs",
+        query: {
+          product,
+          page,
+          limit: pageSize,
+        },
+      });
+
+      if (payload.error) {
+        throw new Error(payload.error);
+      }
+
+      const pageBugs = Array.isArray(payload.bugs) ? payload.bugs : [];
+      total = payload.total ?? total;
+      for (const bug of pageBugs) {
+        bugs.push(bug);
+        if (cap > 0 && bugs.length >= cap) {
+          return { bugs, total };
+        }
+      }
+
+      if (total !== null && payload.limit) {
+        if (page * payload.limit >= total) break;
+      } else if (pageBugs.length < pageSize) {
+        break;
+      }
+
+      page += 1;
+    }
+
+    return { bugs, total };
+  }
+
   async bugStats({ includeZero, limit }) {
     const productsResponse = await this.listProducts({ page: 1, limit: toInt(limit, 1000) });
     if (productsResponse.status !== 1) return productsResponse;
@@ -183,6 +255,86 @@ class ZentaoClient {
       products: rows,
     });
   }
+
+  async bugsMine({
+    account,
+    scope,
+    productIds,
+    includeZero,
+    perPage,
+    maxItems,
+    includeDetails,
+  }) {
+    const matchAccount = normalizeAccountValue(account || this.account);
+    const targetScope = (scope || "assigned").toLowerCase();
+
+    const productsResponse = await this.listProducts({ page: 1, limit: 1000 });
+    if (productsResponse.status !== 1) return productsResponse;
+    const products = productsResponse.result.products || [];
+
+    const productSet = Array.isArray(productIds) && productIds.length
+      ? new Set(productIds.map((id) => Number(id)))
+      : null;
+
+    const rows = [];
+    const bugs = [];
+    let totalMatches = 0;
+    const maxCollect = toInt(maxItems, 200);
+
+    for (const product of products) {
+      if (productSet && !productSet.has(Number(product.id))) continue;
+      const { bugs: productBugs } = await this.fetchAllBugsForProduct({
+        product: product.id,
+        perPage,
+      });
+
+      const matches = productBugs.filter((bug) => {
+        const assigned = matchesAccount(bug.assignedTo, matchAccount);
+        const opened = matchesAccount(bug.openedBy, matchAccount);
+        const resolved = matchesAccount(bug.resolvedBy, matchAccount);
+        if (targetScope === "assigned") return assigned;
+        if (targetScope === "opened") return opened;
+        if (targetScope === "resolved") return resolved;
+        return assigned || opened || resolved;
+      });
+
+      if (!includeZero && matches.length === 0) continue;
+      totalMatches += matches.length;
+
+      rows.push({
+        id: product.id,
+        name: product.name,
+        totalBugs: toInt(product.totalBugs, 0),
+        myBugs: matches.length,
+      });
+
+      if (includeDetails && bugs.length < maxCollect) {
+        for (const bug of matches) {
+          if (bugs.length >= maxCollect) break;
+          bugs.push({
+            id: bug.id,
+            title: bug.title,
+            product: bug.product,
+            status: bug.status,
+            pri: bug.pri,
+            severity: bug.severity,
+            assignedTo: bug.assignedTo,
+            openedBy: bug.openedBy,
+            resolvedBy: bug.resolvedBy,
+            openedDate: bug.openedDate,
+          });
+        }
+      }
+    }
+
+    return normalizeResult({
+      account: matchAccount,
+      scope: targetScope,
+      total: totalMatches,
+      products: rows,
+      bugs: includeDetails ? bugs : [],
+    });
+  }
 }
 
 function createClient() {
@@ -206,7 +358,7 @@ function getClient() {
 const server = new Server(
   {
     name: "zentao-mcp",
-    version: "0.2.0",
+    version: "0.3.1",
   },
   {
     capabilities: {
@@ -254,6 +406,30 @@ const tools = [
       additionalProperties: false,
     },
   },
+  {
+    name: "zentao_bugs_mine",
+    description: "List my bugs (我的Bug) by assignment or creator. Default scope is assigned. Use when user asks for 'my bugs', '我的bug', '分配给我', or personal bug list.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        account: { type: "string", description: "Account to match (default: login account)." },
+        scope: {
+          type: "string",
+          description: "Filter scope: assigned|opened|resolved|all (default assigned).",
+        },
+        productIds: {
+          type: "array",
+          items: { type: "integer" },
+          description: "Optional product IDs to limit search.",
+        },
+        includeZero: { type: "boolean", description: "Include products with zero matches (default false)." },
+        perPage: { type: "integer", description: "Page size when scanning products (default 100)." },
+        maxItems: { type: "integer", description: "Max bug items to return (default 200)." },
+        includeDetails: { type: "boolean", description: "Include bug details list (default false)." },
+      },
+      additionalProperties: false,
+    },
+  },
 ];
 
 server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools }));
@@ -273,6 +449,9 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
       case "zentao_bugs_stats":
         result = await api.bugStats(args);
         break;
+      case "zentao_bugs_mine":
+        result = await api.bugsMine(args);
+        break;
       default:
         return {
           isError: true,