@dyno181cm.nexsoft/zentao_mcp 1.6.0 → 1.7.0

package/README.md

@@ -7,7 +7,7 @@
 [![Node.js](https://img.shields.io/badge/node-%3E%3D18-brightgreen?style=flat-square&logo=node.js)](https://nodejs.org)
 [![TypeScript](https://img.shields.io/badge/TypeScript-5.x-3178C6?style=flat-square&logo=typescript)](https://www.typescriptlang.org)
 [![MCP](https://img.shields.io/badge/MCP-compatible-8A2BE2?style=flat-square)](https://modelcontextprotocol.io)
-[![Tests](https://img.shields.io/badge/tests-26%20passed-brightgreen?style=flat-square&logo=jest)](https://github.com/dyno-nexsoft/zentao_mcp/tree/master/tests)
+[![Tests](https://img.shields.io/badge/tests-13%20passed-brightgreen?style=flat-square&logo=jest)](https://github.com/dyno-nexsoft/zentao_mcp/tree/master/tests)
 
 A **Model Context Protocol (MCP)** server for integrating AI assistants (Claude, Cursor, etc.) with the [ZenTao](https://www.zentao.net) project management API.  
 Fetch task details, bug reports, and attachments — all directly inside your AI chat.
@@ -18,13 +18,12 @@ Fetch task details, bug reports, and attachments — all directly inside your AI
 
 | Tool | Description |
 |---|---|
-| `zentao_get_task_details` | Fetch full details of a task by ID (status, assignee, description, history & comments, attachments) |
-| `zentao_get_bug_details` | Fetch full details of a bug by ID (severity, repro steps, history & comments, inline images, attachments) |
-| `zentao_download_attachment` | Download any ZenTao file attachment to local disk |
+| `zentao_get_details` | Fetch full details of a task or bug by ID |
 | `zentao_get_comments` | Fetch only the history and comments timeline of a task or bug |
 | `zentao_add_comment` | Add a comment/remark to a task or bug |
 | `zentao_update_task_status` | Update task status (start, finish, close, pause, cancel, restart) and add optional comments/hours |
 | `zentao_update_bug_status` | Update bug status (resolve, close, activate) and add optional comments/resolutions |
+| `zentao_get_assigned_to_me` | Get tasks and bugs currently assigned to you (configured via `ZENTAO_ACCOUNT`) |
 
 
 **Under the hood:**
@@ -104,27 +103,13 @@ Add to your MCP client config (e.g. `claude_desktop_config.json`):
 
 ## 🛠️ Available Tools
 
-### `zentao_get_task_details`
-Get full details of a ZenTao task.
+### `zentao_get_details`
+Get full details of a ZenTao task or bug, including repro steps (for bugs), inline images, attachments, history, and comments.
 
 | Parameter | Type | Required | Description |
 |---|---|---|---|
-| `taskId` | `string \| number` | ✅ | Task ID |
-
-### `zentao_get_bug_details`
-Get full details of a ZenTao bug, including repro steps and inline images.
-
-| Parameter | Type | Required | Description |
-|---|---|---|---|
-| `bugId` | `string \| number` | ✅ | Bug ID |
-
-### `zentao_download_attachment`
-Download a ZenTao file attachment to local disk.
-
-| Parameter | Type | Required | Description |
-|---|---|---|---|
-| `fileId` | `string \| number` | ✅ | File ID to download |
-| `extension` | `string` | ❌ | File extension hint (e.g. `mp4`, `png`) |
+| `type` | `"task" \| "bug"` | ✅ | Type of the object |
+| `id` | `string \| number` | ✅ | Task or Bug ID |
 
 ### `zentao_get_comments`
 Get only the history and comments timeline of a task or bug.
@@ -171,6 +156,9 @@ Update a bug's status with optional comments and resolutions.
 | `assignedTo` | `string` | ❌ | Optional user account to assign to next |
 | `openedBuild` | `string` | ❌ | Optional build ID where bug was found (for `activate`) |
 
+### `zentao_get_assigned_to_me`
+Get tasks and bugs currently assigned to the configured user account. Takes no arguments.
+
 ---
 
 ## 🧑‍💻 Development
@@ -198,19 +186,19 @@ src/
 │   ├── attachmentRenderer.ts # Attachments → Markdown ## Files section
 │   ├── actionFormatter.ts    # renderHistoryAndComments
 │   ├── taskFormatter.ts      # taskToMarkdown (includes comments)
-│   └── bugFormatter.ts       # bugToMarkdown (includes comments)
+│   ├── bugFormatter.ts       # bugToMarkdown (includes comments)
+│   └── myWorkFormatter.ts    # myWorkToMarkdown (includes comments)
 └── tools/
-    ├── taskTool.ts           # zentao_get_task_details
-    ├── bugTool.ts            # zentao_get_bug_details
-    ├── downloadTool.ts       # zentao_download_attachment
+    ├── detailTool.ts         # zentao_get_details
     ├── commentTool.ts        # zentao_get_comments · zentao_add_comment
-    └── statusTool.ts         # zentao_update_task_status · zentao_update_bug_status
+    ├── statusTool.ts         # zentao_update_task_status · zentao_update_bug_status
+    └── myWorkTool.ts         # zentao_get_assigned_to_me
 ```
 
 ### Running tests
 
 ```bash
-npm test           # Unit tests — 26 tests across ZentaoClient + formatters
+npm test           # Unit tests — 13 tests across ZentaoClient
 npm run test:api   # Live API integration test (requires .env)
 ```
 

package/build/tools/detailTool.js

@@ -0,0 +1,32 @@
+import { z } from "zod";
+import { taskToMarkdown } from "../formatters/taskFormatter.js";
+import { bugToMarkdown } from "../formatters/bugFormatter.js";
+import { buildMcpResponse } from "../utils/mcpResponse.js";
+/**
+ * Register the `zentao_get_details` MCP tool on the given server.
+ *
+ * @param server The MCP Server instance.
+ * @param client Authenticated ZentaoClient used to fetch and process data.
+ */
+export function registerDetailTool(server, client) {
+    server.registerTool("zentao_get_details", {
+        description: "Get detailed information of a task or a bug",
+        inputSchema: {
+            type: z.enum(["task", "bug"]).describe("Type of the object ('task' or 'bug')"),
+            id: z.union([z.string(), z.number()]).describe("Task or Bug ID"),
+        },
+    }, async ({ type, id }) => {
+        let data;
+        let markdown;
+        const downloadedImages = [];
+        if (type === "task") {
+            data = await client.getTaskDetails(id);
+            markdown = await taskToMarkdown(data, client, downloadedImages);
+        }
+        else {
+            data = await client.getBugDetails(id);
+            markdown = await bugToMarkdown(data, client, downloadedImages);
+        }
+        return await buildMcpResponse(markdown, downloadedImages);
+    });
+}

package/build/tools.js

@@ -13,9 +13,7 @@
 import { ZentaoClient } from "./zentaoClient.js";
 import { taskToMarkdown as _taskToMarkdown, } from "./formatters/taskFormatter.js";
 import { bugToMarkdown as _bugToMarkdown, } from "./formatters/bugFormatter.js";
-import { registerTaskTool } from "./tools/taskTool.js";
-import { registerBugTool } from "./tools/bugTool.js";
-import { registerDownloadTool } from "./tools/downloadTool.js";
+import { registerDetailTool } from "./tools/detailTool.js";
 import { registerCommentTool } from "./tools/commentTool.js";
 import { registerStatusTools } from "./tools/statusTool.js";
 import { registerMyWorkTool } from "./tools/myWorkTool.js";
@@ -37,9 +35,7 @@ export function bugToMarkdown(rawBug, downloadedImages) {
  * Registers all Zentao MCP tools on the provided server instance.
  *
  * Available tools:
- * - `zentao_get_task_details`     — Fetch full details of a task by ID.
- * - `zentao_get_bug_details`      — Fetch full details of a bug by ID.
- * - `zentao_download_attachment`  — Download an attachment and save locally.
+ * - `zentao_get_details`          — Fetch full details of a task or a bug by ID.
  * - `zentao_get_comments`         — Fetch history and comments timeline for task/bug.
  * - `zentao_update_task_status`   — Update a task's status with comments.
  * - `zentao_update_bug_status`    — Update a bug's status with comments.
@@ -47,9 +43,7 @@ export function bugToMarkdown(rawBug, downloadedImages) {
  * @param server The MCP Server instance where the tools will be registered.
  */
 export function registerTools(server) {
-    registerTaskTool(server, client);
-    registerBugTool(server, client);
-    registerDownloadTool(server, client);
+    registerDetailTool(server, client);
     registerCommentTool(server, client);
     registerStatusTools(server, client);
     registerMyWorkTool(server, client);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dyno181cm.nexsoft/zentao_mcp",
-  "version": "1.6.0",
+  "version": "1.7.0",
   "description": "Zentao MCP Server",
   "repository": {
     "type": "git",

package/build/tools/bugTool.js

@@ -1,22 +0,0 @@
-import { z } from "zod";
-import { bugToMarkdown } from "../formatters/bugFormatter.js";
-import { buildMcpResponse } from "../utils/mcpResponse.js";
-/**
- * Register the `zentao_get_bug_details` MCP tool on the given server.
- *
- * @param server The MCP Server instance.
- * @param client Authenticated ZentaoClient used to fetch and process data.
- */
-export function registerBugTool(server, client) {
-    server.registerTool("zentao_get_bug_details", {
-        description: "Get detailed information of a bug",
-        inputSchema: {
-            bugId: z.union([z.string(), z.number()]).describe("Bug ID"),
-        },
-    }, async ({ bugId }) => {
-        const data = await client.getBugDetails(bugId);
-        const downloadedImages = [];
-        const markdown = await bugToMarkdown(data, client, downloadedImages);
-        return await buildMcpResponse(markdown, downloadedImages);
-    });
-}

package/build/tools/downloadTool.js

@@ -1,56 +0,0 @@
-import { z } from "zod";
-import * as os from "os";
-import * as path from "path";
-import fs from "fs";
-import { mcpText } from "../utils/mcpResponse.js";
-/** Tracks in-flight downloads to deduplicate concurrent requests for the same file. */
-const activeDownloads = new Map();
-/**
- * Download a ZenTao attachment to a local path.
- * Deduplicates concurrent requests for the same target file.
- */
-async function downloadAttachment(client, fileId, targetPath) {
-    if (fs.existsSync(targetPath) && !activeDownloads.has(targetPath)) {
-        return `File already exists locally at: ${targetPath}`;
-    }
-    if (activeDownloads.has(targetPath)) {
-        await activeDownloads.get(targetPath);
-        return `File downloaded successfully to: ${targetPath}`;
-    }
-    const downloadPromise = client.downloadFile(fileId, targetPath);
-    activeDownloads.set(targetPath, downloadPromise);
-    try {
-        const savedPath = await downloadPromise;
-        return `File downloaded successfully to: ${savedPath}`;
-    }
-    finally {
-        activeDownloads.delete(targetPath);
-    }
-}
-/**
- * Register the `zentao_download_attachment` MCP tool on the given server.
- *
- * @param server The MCP Server instance.
- * @param client Authenticated ZentaoClient used for downloading files.
- */
-export function registerDownloadTool(server, client) {
-    server.registerTool("zentao_download_attachment", {
-        description: "Download a file attachment from ZenTao and save it locally",
-        inputSchema: {
-            fileId: z.union([z.string(), z.number()]).describe("File ID to download"),
-            extension: z.string().optional().describe("Optional file extension (e.g., mp4, png)"),
-        },
-    }, async ({ fileId, extension }) => {
-        const ext = extension
-            ? extension.startsWith('.') ? extension : `.${extension}`
-            : '';
-        const targetPath = path.join(os.tmpdir(), `zentao_file_${fileId}${ext}`);
-        try {
-            const message = await downloadAttachment(client, fileId, targetPath);
-            return mcpText(message);
-        }
-        catch (error) {
-            return mcpText(`Failed to download file: ${error.message}`);
-        }
-    });
-}

package/build/tools/taskTool.js

@@ -1,22 +0,0 @@
-import { z } from "zod";
-import { taskToMarkdown } from "../formatters/taskFormatter.js";
-import { buildMcpResponse } from "../utils/mcpResponse.js";
-/**
- * Register the `zentao_get_task_details` MCP tool on the given server.
- *
- * @param server The MCP Server instance.
- * @param client Authenticated ZentaoClient used to fetch and process data.
- */
-export function registerTaskTool(server, client) {
-    server.registerTool("zentao_get_task_details", {
-        description: "Get detailed information of a task",
-        inputSchema: {
-            taskId: z.union([z.string(), z.number()]).describe("Task ID"),
-        },
-    }, async ({ taskId }) => {
-        const data = await client.getTaskDetails(taskId);
-        const downloadedImages = [];
-        const markdown = await taskToMarkdown(data, client, downloadedImages);
-        return await buildMcpResponse(markdown, downloadedImages);
-    });
-}