@xihe-lab/tapd-mcp-server 1.3.0 → 1.4.0

package/dist/tools/board.js

@@ -0,0 +1,98 @@
+import { z } from 'zod';
+import { TapdClient } from '../tapd-client.js';
+export const boardTools = [
+    {
+        name: "tapd_add_board_card",
+        description: "新建看板工作项",
+        inputSchema: z.object({
+            workspace_id: z.number().optional().describe('项目ID（可省略，使用默认配置）'),
+            board_id: z.number().describe("看板ID (必填)"),
+            column_id: z.number().describe("看板列ID (必填)"),
+            name: z.string().describe("工作项标题 (必填)"),
+            description: z.string().optional().describe("详细描述"),
+            owner: z.string().optional().describe("负责人，默认当前用户"),
+            creator: z.string().optional().describe("创建人，默认当前用户"),
+            priority: z.string().optional().describe("优先级"),
+            category_id: z.number().optional().describe("分类ID"),
+            due: z.string().optional().describe("预计完成日期，格式: YYYY-MM-DD"),
+        }),
+        handler: async (client, params) => {
+            const workspaceId = params.workspace_id ?? TapdClient.getDefaultWorkspaceId();
+            if (!workspaceId) {
+                throw new Error('workspace_id is required (either provide it or set TAPD_DEFAULT_WORKSPACE_ID env)');
+            }
+            return client.post("/board_cards/add", { ...params, workspace_id: workspaceId });
+        },
+    },
+    {
+        name: "tapd_get_board_cards",
+        description: "获取看板工作项列表",
+        inputSchema: z.object({
+            workspace_id: z.number().optional().describe('项目ID（可省略，使用默认配置）'),
+            board_id: z.number().optional().describe("看板ID"),
+            column_id: z.number().optional().describe("看板列ID"),
+            id: z.string().optional().describe("工作项ID，支持多ID查询"),
+            name: z.string().optional().describe("工作项标题，支持模糊匹配"),
+            owner: z.string().optional().describe("负责人"),
+            creator: z.string().optional().describe("创建人"),
+            status: z.string().optional().describe("状态"),
+            priority: z.string().optional().describe("优先级"),
+            category_id: z.number().optional().describe("分类ID"),
+            created: z.string().optional().describe("创建时间，支持时间查询"),
+            modified: z.string().optional().describe("修改时间，支持时间查询"),
+            due: z.string().optional().describe("预计完成日期，支持时间查询"),
+            limit: z.number().optional().describe("返回数量限制，默认30，最大200"),
+            page: z.number().optional().describe("页码，默认1"),
+            order: z.string().optional().describe("排序规则，如 created desc"),
+            fields: z.string().optional().describe("指定返回字段，多个字段以逗号分隔"),
+        }),
+        handler: async (client, params) => {
+            const workspaceId = params.workspace_id ?? TapdClient.getDefaultWorkspaceId();
+            if (!workspaceId) {
+                throw new Error('workspace_id is required (either provide it or set TAPD_DEFAULT_WORKSPACE_ID env)');
+            }
+            return client.get("/board_cards", { ...params, workspace_id: workspaceId });
+        },
+    },
+    {
+        name: "tapd_update_board_card",
+        description: "更新看板工作项",
+        inputSchema: z.object({
+            id: z.string().describe("工作项ID (必填)"),
+            workspace_id: z.number().optional().describe('项目ID（可省略，使用默认配置）'),
+            board_id: z.number().optional().describe("看板ID"),
+            column_id: z.number().optional().describe("看板列ID（用于移动卡片）"),
+            name: z.string().optional().describe("工作项标题"),
+            description: z.string().optional().describe("详细描述"),
+            owner: z.string().optional().describe("负责人"),
+            status: z.string().optional().describe("状态"),
+            priority: z.string().optional().describe("优先级"),
+            due: z.string().optional().describe("预计完成日期，格式: YYYY-MM-DD"),
+        }),
+        handler: async (client, params) => {
+            const workspaceId = params.workspace_id ?? TapdClient.getDefaultWorkspaceId();
+            if (!workspaceId) {
+                throw new Error('workspace_id is required (either provide it or set TAPD_DEFAULT_WORKSPACE_ID env)');
+            }
+            return client.post("/board_cards/update", { ...params, workspace_id: workspaceId });
+        },
+    },
+    {
+        name: "tapd_get_board_columns",
+        description: "获取看板板块",
+        inputSchema: z.object({
+            workspace_id: z.number().optional().describe('项目ID（可省略，使用默认配置）'),
+            board_id: z.number().describe("看板ID (必填)"),
+            id: z.number().optional().describe("看板列ID"),
+            fields: z.string().optional().describe("指定返回字段"),
+        }),
+        handler: async (client, params) => {
+            const workspaceId = params.workspace_id ?? TapdClient.getDefaultWorkspaceId();
+            if (!workspaceId) {
+                throw new Error('workspace_id is required (either provide it or set TAPD_DEFAULT_WORKSPACE_ID env)');
+            }
+            return client.get("/board_columns", { ...params, workspace_id: workspaceId });
+        },
+    },
+];
+//# sourceMappingURL=board.js.map

package/dist/tools/board.js.map

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

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

@@ -1 +1 @@
-{"version":3,"file":"bug.d.ts","sourceRoot":"","sources":["../../src/tools/bug.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAG3C,eAAO,MAAM,QAAQ,EAAE,OAAO,EAgP7B,CAAC"}
+{"version":3,"file":"bug.d.ts","sourceRoot":"","sources":["../../src/tools/bug.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAG3C,eAAO,MAAM,QAAQ,EAAE,OAAO,EAumB7B,CAAC"}

package/dist/tools/bug.js

@@ -5,7 +5,7 @@ export const bugTools = [
         name: 'tapd_get_bugs',
         description: 'Query TAPD bugs with filters',
         inputSchema: z.object({
-            workspace_id: z.number().describe('Project ID'),
+            workspace_id: z.number().optional().describe('项目ID（可省略，使用默认配置）'),
             id: z.string().optional().describe('Supports multiple IDs'),
             title: z.string().optional().describe('Bug title, supports fuzzy matching'),
             priority: z.string().optional().describe('Priority, recommend using priority_label'),
@@ -63,14 +63,23 @@ export const bugTools = [
             fields: z.string().optional().describe('Specify return fields'),
         }),
         handler: async (client, params) => {
-            return client.get('/bugs', params);
+            const workspaceId = params.workspace_id ?? TapdClient.getDefaultWorkspaceId();
+            if (!workspaceId) {
+                throw new Error('workspace_id is required (either provide it or set TAPD_DEFAULT_WORKSPACE_ID env)');
+            }
+            const convertedParams = {
+                ...params,
+                id: params.id ? TapdClient.toLongId(params.id, workspaceId) : undefined,
+                workspace_id: workspaceId,
+            };
+            return client.get('/bugs', convertedParams);
         },
     },
     {
         name: 'tapd_create_bug',
         description: 'Create a new bug in TAPD',
         inputSchema: z.object({
-            workspace_id: z.number().describe('Project ID (required)'),
+            workspace_id: z.number().optional().describe('项目ID（可省略，使用默认配置）'),
             title: z.string().describe('Bug title (required)'),
             priority: z.string().optional().describe('Priority'),
             priority_label: z.string().optional().describe('Priority label (recommended)'),
@@ -87,6 +96,10 @@ export const bugTools = [
             de: z.string().optional().describe('Developer'),
             reporter: z.string().optional().describe('Reporter'),
             participator: z.string().optional().describe('Participant'),
+            auditer: z.string().optional().describe('Auditor'),
+            confirmer: z.string().optional().describe('Confirmer'),
+            fixer: z.string().optional().describe('Fixer'),
+            closer: z.string().optional().describe('Closer'),
             begin: z.string().optional().describe('Estimated start date, Format: YYYY-MM-DD'),
             due: z.string().optional().describe('Estimated end date, Format: YYYY-MM-DD'),
             deadline: z.string().optional().describe('Resolve deadline, Format: YYYY-MM-DD'),
@@ -116,9 +129,14 @@ export const bugTools = [
             custom_field_one: z.string().optional().describe('Custom field 1 (supports 1-200)'),
         }),
         handler: async (client, params) => {
+            const workspaceId = params.workspace_id ?? TapdClient.getDefaultWorkspaceId();
+            if (!workspaceId) {
+                throw new Error('workspace_id is required (either provide it or set TAPD_DEFAULT_WORKSPACE_ID env)');
+            }
             const nickName = TapdClient.getNickName();
             const finalParams = {
                 ...params,
+                workspace_id: workspaceId,
                 current_owner: params.current_owner ?? nickName,
                 reporter: params.reporter ?? nickName,
             };
@@ -130,7 +148,7 @@ export const bugTools = [
         description: 'Update an existing bug in TAPD',
         inputSchema: z.object({
             id: z.string().describe('Bug ID (required)'),
-            workspace_id: z.number().describe('Project ID (required)'),
+            workspace_id: z.number().optional().describe('项目ID（可省略，使用默认配置）'),
             title: z.string().optional().describe('Bug title'),
             priority: z.string().optional().describe('Priority'),
             priority_label: z.string().optional().describe('Priority label (recommended)'),
@@ -176,14 +194,23 @@ export const bugTools = [
             custom_field_one: z.string().optional().describe('Custom field 1 (supports 1-200)'),
         }),
         handler: async (client, params) => {
-            return client.post('/bugs', params);
+            const workspaceId = params.workspace_id ?? TapdClient.getDefaultWorkspaceId();
+            if (!workspaceId) {
+                throw new Error('workspace_id is required (either provide it or set TAPD_DEFAULT_WORKSPACE_ID env)');
+            }
+            const convertedParams = {
+                ...params,
+                id: TapdClient.toLongId(params.id, workspaceId),
+                workspace_id: workspaceId,
+            };
+            return client.post('/bugs', convertedParams);
         },
     },
     {
         name: 'tapd_get_bug_count',
         description: 'Get the count of bugs matching filters',
         inputSchema: z.object({
-            workspace_id: z.number().describe('Project ID (required)'),
+            workspace_id: z.number().optional().describe('项目ID（可省略，使用默认配置）'),
             id: z.string().optional().describe('Supports multiple IDs'),
             title: z.string().optional().describe('Bug title, supports fuzzy matching'),
             priority: z.string().optional().describe('Priority, recommend using priority_label'),
@@ -237,7 +264,355 @@ export const bugTools = [
             custom_field_one: z.string().optional().describe('Custom field 1 (supports 1-200)'),
         }),
         handler: async (client, params) => {
-            return client.get('/bugs/count', params);
+            const workspaceId = params.workspace_id ?? TapdClient.getDefaultWorkspaceId();
+            if (!workspaceId) {
+                throw new Error('workspace_id is required (either provide it or set TAPD_DEFAULT_WORKSPACE_ID env)');
+            }
+            const convertedParams = {
+                ...params,
+                id: params.id ? TapdClient.toLongId(params.id, workspaceId) : undefined,
+                workspace_id: workspaceId,
+            };
+            return client.get('/bugs/count', convertedParams);
+        },
+    },
+    // 缺陷变更历史
+    {
+        name: 'tapd_get_bug_changes',
+        description: '获取缺陷变更历史',
+        inputSchema: z.object({
+            workspace_id: z.number().optional().describe('项目ID（可省略，使用默认配置）'),
+            id: z.string().optional().describe('变更记录ID，支持多ID查询'),
+            bug_id: z.string().optional().describe('缺陷ID'),
+            field: z.string().optional().describe('变更字段'),
+            value_before: z.string().optional().describe('变更前值'),
+            value_after: z.string().optional().describe('变更后值'),
+            user: z.string().optional().describe('变更人'),
+            created: z.string().optional().describe('创建时间，支持时间查询'),
+            limit: z.number().optional().describe('返回数量，默认30，最大200'),
+            page: z.number().optional().describe('页码，默认1'),
+            order: z.string().optional().describe('排序'),
+            fields: z.string().optional().describe('返回字段'),
+        }),
+        handler: async (client, params) => {
+            const workspaceId = params.workspace_id ?? TapdClient.getDefaultWorkspaceId();
+            if (!workspaceId) {
+                throw new Error('workspace_id is required (either provide it or set TAPD_DEFAULT_WORKSPACE_ID env)');
+            }
+            const convertedParams = {
+                ...params,
+                bug_id: params.bug_id ? TapdClient.toLongId(params.bug_id, workspaceId) : undefined,
+                workspace_id: workspaceId,
+            };
+            return client.get('/bug_changes', convertedParams);
+        },
+    },
+    {
+        name: 'tapd_get_bug_changes_count',
+        description: '获取缺陷变更次数',
+        inputSchema: z.object({
+            workspace_id: z.number().optional().describe('项目ID（可省略，使用默认配置）'),
+            bug_id: z.string().optional().describe('缺陷ID'),
+            field: z.string().optional().describe('变更字段'),
+            user: z.string().optional().describe('变更人'),
+            created: z.string().optional().describe('创建时间'),
+        }),
+        handler: async (client, params) => {
+            const workspaceId = params.workspace_id ?? TapdClient.getDefaultWorkspaceId();
+            if (!workspaceId) {
+                throw new Error('workspace_id is required (either provide it or set TAPD_DEFAULT_WORKSPACE_ID env)');
+            }
+            const convertedParams = {
+                ...params,
+                bug_id: params.bug_id ? TapdClient.toLongId(params.bug_id, workspaceId) : undefined,
+                workspace_id: workspaceId,
+            };
+            return client.get('/bug_changes/count', convertedParams);
+        },
+    },
+    // 缺陷字段配置
+    {
+        name: 'tapd_get_bug_custom_fields_settings',
+        description: '获取缺陷自定义字段配置',
+        inputSchema: z.object({
+            workspace_id: z.number().optional().describe('项目ID（可省略，使用默认配置）'),
+        }),
+        handler: async (client, params) => {
+            const workspaceId = params.workspace_id ?? TapdClient.getDefaultWorkspaceId();
+            if (!workspaceId) {
+                throw new Error('workspace_id is required (either provide it or set TAPD_DEFAULT_WORKSPACE_ID env)');
+            }
+            return client.get('/bugs/custom_fields_settings', { ...params, workspace_id: workspaceId });
+        },
+    },
+    {
+        name: 'tapd_get_bug_fields_info',
+        description: '获取缺陷字段信息',
+        inputSchema: z.object({
+            workspace_id: z.number().optional().describe('项目ID（可省略，使用默认配置）'),
+        }),
+        handler: async (client, params) => {
+            const workspaceId = params.workspace_id ?? TapdClient.getDefaultWorkspaceId();
+            if (!workspaceId) {
+                throw new Error('workspace_id is required (either provide it or set TAPD_DEFAULT_WORKSPACE_ID env)');
+            }
+            return client.get('/bugs/get_fields_info', { ...params, workspace_id: workspaceId });
+        },
+    },
+    {
+        name: 'tapd_get_bug_fields_lable',
+        description: '获取缺陷字段中英文对照',
+        inputSchema: z.object({
+            workspace_id: z.number().optional().describe('项目ID（可省略，使用默认配置）'),
+        }),
+        handler: async (client, params) => {
+            const workspaceId = params.workspace_id ?? TapdClient.getDefaultWorkspaceId();
+            if (!workspaceId) {
+                throw new Error('workspace_id is required (either provide it or set TAPD_DEFAULT_WORKSPACE_ID env)');
+            }
+            return client.get('/bugs/fields_lable', { ...params, workspace_id: workspaceId });
+        },
+    },
+    // 缺陷模板
+    {
+        name: 'tapd_get_bug_template_list',
+        description: '获取缺陷模板列表',
+        inputSchema: z.object({
+            workspace_id: z.number().optional().describe('项目ID（可省略，使用默认配置）'),
+            limit: z.number().optional().describe('返回数量'),
+            page: z.number().optional().describe('页码'),
+            fields: z.string().optional().describe('返回字段'),
+        }),
+        handler: async (client, params) => {
+            const workspaceId = params.workspace_id ?? TapdClient.getDefaultWorkspaceId();
+            if (!workspaceId) {
+                throw new Error('workspace_id is required (either provide it or set TAPD_DEFAULT_WORKSPACE_ID env)');
+            }
+            return client.get('/bugs/templates', { ...params, workspace_id: workspaceId });
+        },
+    },
+    {
+        name: 'tapd_get_default_bug_template',
+        description: '获取缺陷默认模板',
+        inputSchema: z.object({
+            workspace_id: z.number().optional().describe('项目ID（可省略，使用默认配置）'),
+        }),
+        handler: async (client, params) => {
+            const workspaceId = params.workspace_id ?? TapdClient.getDefaultWorkspaceId();
+            if (!workspaceId) {
+                throw new Error('workspace_id is required (either provide it or set TAPD_DEFAULT_WORKSPACE_ID env)');
+            }
+            return client.get('/bugs/default_template', { ...params, workspace_id: workspaceId });
+        },
+    },
+    // 批量操作
+    {
+        name: 'tapd_batch_update_bugs',
+        description: '批量更新缺陷',
+        inputSchema: z.object({
+            workspace_id: z.number().optional().describe('项目ID（可省略，使用默认配置）'),
+            bugs: z.string().describe('缺陷更新数组JSON，最多50条 (必填)'),
+        }),
+        handler: async (client, params) => {
+            const workspaceId = params.workspace_id ?? TapdClient.getDefaultWorkspaceId();
+            if (!workspaceId) {
+                throw new Error('workspace_id is required (either provide it or set TAPD_DEFAULT_WORKSPACE_ID env)');
+            }
+            // TAPD API expects bugs as a JSON string
+            // Parse and convert bug IDs
+            const bugsJson = params.bugs;
+            const bugs = JSON.parse(bugsJson);
+            const convertedBugs = bugs.map((bug) => {
+                const { id, ...rest } = bug;
+                return {
+                    id: TapdClient.toLongId(id, workspaceId),
+                    ...rest,
+                };
+            });
+            const convertedBugsJson = JSON.stringify(convertedBugs);
+            return client.post('/bugs/batch_update', {
+                workspace_id: workspaceId,
+                bugs: convertedBugsJson,
+            });
+        },
+    },
+    {
+        name: 'tapd_copy_bug',
+        description: '复制缺陷',
+        inputSchema: z.object({
+            workspace_id: z.number().optional().describe('项目ID（可省略，使用默认配置）'),
+            id: z.string().describe('要复制的缺陷ID (必填)'),
+            title: z.string().optional().describe('新缺陷标题（默认为原标题）'),
+            current_owner: z.string().optional().describe('处理人'),
+            iteration_id: z.string().optional().describe('迭代ID'),
+            copy_attachments: z.number().optional().describe('是否复制附件，值=1复制'),
+            copy_comments: z.number().optional().describe('是否复制评论，值=1复制'),
+        }),
+        handler: async (client, params) => {
+            const workspaceId = params.workspace_id ?? TapdClient.getDefaultWorkspaceId();
+            if (!workspaceId) {
+                throw new Error('workspace_id is required (either provide it or set TAPD_DEFAULT_WORKSPACE_ID env)');
+            }
+            const convertedParams = {
+                ...params,
+                id: TapdClient.toLongId(params.id, workspaceId),
+                workspace_id: workspaceId,
+            };
+            return client.post('/bugs/copy', convertedParams);
+        },
+    },
+    // 缺陷关联
+    {
+        name: 'tapd_get_link_bugs',
+        description: '获取缺陷关联关系',
+        inputSchema: z.object({
+            workspace_id: z.number().optional().describe('项目ID（可省略，使用默认配置）'),
+            bug_id: z.string().describe('缺陷ID (必填)'),
+        }),
+        handler: async (client, params) => {
+            const workspaceId = params.workspace_id ?? TapdClient.getDefaultWorkspaceId();
+            if (!workspaceId) {
+                throw new Error('workspace_id is required (either provide it or set TAPD_DEFAULT_WORKSPACE_ID env)');
+            }
+            const convertedParams = {
+                ...params,
+                bug_id: TapdClient.toLongId(params.bug_id, workspaceId),
+                workspace_id: workspaceId,
+            };
+            return client.get('/bugs/get_link_bugs', convertedParams);
+        },
+    },
+    {
+        name: 'tapd_link_bugs',
+        description: '关联缺陷',
+        inputSchema: z.object({
+            workspace_id: z.number().optional().describe('项目ID（可省略，使用默认配置）'),
+            bug_id: z.string().describe('主缺陷ID (必填)'),
+            link_bug_id: z.string().describe('关联缺陷ID (必填)'),
+            link_type: z.string().optional().describe('关联类型（前置/后置等）'),
+        }),
+        handler: async (client, params) => {
+            const workspaceId = params.workspace_id ?? TapdClient.getDefaultWorkspaceId();
+            if (!workspaceId) {
+                throw new Error('workspace_id is required (either provide it or set TAPD_DEFAULT_WORKSPACE_ID env)');
+            }
+            const convertedParams = {
+                ...params,
+                bug_id: TapdClient.toLongId(params.bug_id, workspaceId),
+                link_bug_id: TapdClient.toLongId(params.link_bug_id, workspaceId),
+                workspace_id: workspaceId,
+            };
+            return client.post('/bugs/link_bugs', convertedParams);
+        },
+    },
+    {
+        name: 'tapd_delete_link_bugs',
+        description: '取消关联缺陷',
+        inputSchema: z.object({
+            workspace_id: z.number().optional().describe('项目ID（可省略，使用默认配置）'),
+            bug_id: z.string().describe('主缺陷ID (必填)'),
+            link_bug_id: z.string().describe('要取消关联的缺陷ID (必填)'),
+        }),
+        handler: async (client, params) => {
+            const workspaceId = params.workspace_id ?? TapdClient.getDefaultWorkspaceId();
+            if (!workspaceId) {
+                throw new Error('workspace_id is required (either provide it or set TAPD_DEFAULT_WORKSPACE_ID env)');
+            }
+            const convertedParams = {
+                ...params,
+                bug_id: TapdClient.toLongId(params.bug_id, workspaceId),
+                link_bug_id: TapdClient.toLongId(params.link_bug_id, workspaceId),
+                workspace_id: workspaceId,
+            };
+            return client.post('/bugs/delete_link_bugs', convertedParams);
+        },
+    },
+    {
+        name: 'tapd_get_related_stories',
+        description: '获取缺陷关联需求',
+        inputSchema: z.object({
+            workspace_id: z.number().optional().describe('项目ID（可省略，使用默认配置）'),
+            bug_id: z.string().describe('缺陷ID (必填)'),
+        }),
+        handler: async (client, params) => {
+            const workspaceId = params.workspace_id ?? TapdClient.getDefaultWorkspaceId();
+            if (!workspaceId) {
+                throw new Error('workspace_id is required (either provide it or set TAPD_DEFAULT_WORKSPACE_ID env)');
+            }
+            const convertedParams = {
+                ...params,
+                bug_id: TapdClient.toLongId(params.bug_id, workspaceId),
+                workspace_id: workspaceId,
+            };
+            return client.get('/bugs/get_related_stories', convertedParams);
+        },
+    },
+    // 其他
+    {
+        name: 'tapd_get_bugs_by_view_conf_id',
+        description: '获取视图缺陷列表',
+        inputSchema: z.object({
+            workspace_id: z.number().optional().describe('项目ID（可省略，使用默认配置）'),
+            view_conf_id: z.string().describe('视图配置ID (必填)'),
+            limit: z.number().optional().describe('返回数量，默认30，最大200'),
+            page: z.number().optional().describe('页码，默认1'),
+            fields: z.string().optional().describe('返回字段'),
+        }),
+        handler: async (client, params) => {
+            const workspaceId = params.workspace_id ?? TapdClient.getDefaultWorkspaceId();
+            if (!workspaceId) {
+                throw new Error('workspace_id is required (either provide it or set TAPD_DEFAULT_WORKSPACE_ID env)');
+            }
+            return client.get('/bugs/by_view_conf_id', { ...params, workspace_id: workspaceId });
+        },
+    },
+    {
+        name: 'tapd_get_removed_bugs',
+        description: '获取回收站缺陷',
+        inputSchema: z.object({
+            workspace_id: z.number().optional().describe('项目ID（可省略，使用默认配置）'),
+            id: z.string().optional().describe('缺陷ID'),
+            title: z.string().optional().describe('标题'),
+            current_owner: z.string().optional().describe('处理人'),
+            reporter: z.string().optional().describe('创建人'),
+            created: z.string().optional().describe('创建时间'),
+            deleted: z.string().optional().describe('删除时间'),
+            limit: z.number().optional().describe('返回数量，默认30，最大200'),
+            page: z.number().optional().describe('页码'),
+            order: z.string().optional().describe('排序'),
+            fields: z.string().optional().describe('返回字段'),
+        }),
+        handler: async (client, params) => {
+            const workspaceId = params.workspace_id ?? TapdClient.getDefaultWorkspaceId();
+            if (!workspaceId) {
+                throw new Error('workspace_id is required (either provide it or set TAPD_DEFAULT_WORKSPACE_ID env)');
+            }
+            const convertedParams = {
+                ...params,
+                id: params.id ? TapdClient.toLongId(params.id, workspaceId) : undefined,
+                workspace_id: workspaceId,
+            };
+            return client.get('/bugs/removed', convertedParams);
+        },
+    },
+    {
+        name: 'tapd_bug_ids_to_query_token',
+        description: '转换缺陷ID为queryToken',
+        inputSchema: z.object({
+            workspace_id: z.number().optional().describe('项目ID（可省略，使用默认配置）'),
+            ids: z.string().describe('缺陷ID列表，逗号分隔 (必填)'),
+        }),
+        handler: async (client, params) => {
+            const workspaceId = params.workspace_id ?? TapdClient.getDefaultWorkspaceId();
+            if (!workspaceId) {
+                throw new Error('workspace_id is required (either provide it or set TAPD_DEFAULT_WORKSPACE_ID env)');
+            }
+            // Convert comma-separated IDs: split → convert each → join
+            const convertedIds = params.ids.split(',').map((id) => TapdClient.toLongId(id.trim(), workspaceId)).join(',');
+            return client.get('/bugs/ids_to_query_token', {
+                workspace_id: workspaceId,
+                ids: convertedIds,
+            });
         },
     },
 ];