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

package/README.md

@@ -33,14 +33,16 @@ TAPD 是腾讯敏捷研发管理平台，覆盖需求、计划、研发、测试
 
 #### 方式一：一键安装命令
 
-注意替换 `your_access_token`、`your_workspace_id` 和 `your_nick_name`：
+注意替换以下参数（必填项标记为 **必填**，其余可选）。`-s user` 为用户级配置（所有项目生效），改为 `-s project` 则仅当前项目生效：
 
 ```bash
 claude mcp add -s user tapd \
-  --env TAPD_ACCESS_TOKEN=your_access_token \
-  --env TAPD_DEFAULT_WORKSPACE_ID=your_workspace_id \
-  --env TAPD_NICK_NAME=your_nick_name \
-  -- npx -y "@xihe-lab/tapd-mcp-server"
+  --env TAPD_ACCESS_TOKEN=your_access_token \                        # 必填：个人访问令牌
+  --env TAPD_DEFAULT_WORKSPACE_ID=your_workspace_id \                # 必填：默认项目 ID
+  --env TAPD_NICK_NAME=your_nick_name \                              # 推荐：用户昵称，用于 owner/creator 默认值
+  --env TAPD_DEFAULT_TASK_WORKITEM_TYPE_ID=your_task_type_id \       # 可选：默认 TASK 类型 ID，可通过 tapd_get_workitem_types 查询
+  --env TAPD_DEFAULT_STORY_WORKITEM_TYPE_ID=your_story_type_id \     # 可选：默认 STORY 类型 ID
+  -- npx -y "@xihe-lab/tapd-mcp-server@latest"
 ```
 
 若忘记替换凭证，重新安装前需先卸载旧的配置：
@@ -59,14 +61,16 @@ claude mcp remove tapd
   "mcpServers": {
     "tapd": {
       "command": "npx",
-      "args": ["-y", "@xihe-lab/tapd-mcp-server"],
+      "args": ["-y", "@xihe-lab/tapd-mcp-server@latest"],
       "env": {
         "TAPD_ACCESS_TOKEN": "",
         "TAPD_API_USER": "",
         "TAPD_API_PASSWORD": "",
         "TAPD_API_BASE_URL": "https://api.tapd.cn",
         "TAPD_DEFAULT_WORKSPACE_ID": "",
-        "TAPD_NICK_NAME": ""
+        "TAPD_NICK_NAME": "",
+        "TAPD_DEFAULT_STORY_WORKITEM_TYPE_ID": "",
+        "TAPD_DEFAULT_TASK_WORKITEM_TYPE_ID": ""
       }
     }
   }
@@ -101,28 +105,43 @@ claude mcp remove tapd
 | `TAPD_API_BASE_URL` | 否 | API 基础地址，默认 `https://api.tapd.cn` |
 | `TAPD_DEFAULT_WORKSPACE_ID` | 否 | 默认项目 ID，省去每次传 workspace_id |
 | `TAPD_NICK_NAME` | 否 | 用户昵称，作为 owner/creator 等参数的默认值 |
+| `TAPD_DEFAULT_STORY_WORKITEM_TYPE_ID` | 否 | 默认 STORY 工作项类型 ID |
+| `TAPD_DEFAULT_TASK_WORKITEM_TYPE_ID` | 否 | 默认 TASK 工作项类型 ID |
 
 注意：`TAPD_API_USER`/`TAPD_API_PASSWORD`（API 账号密码）与 `TAPD_ACCESS_TOKEN`（个人访问令牌）为两种调用方式，选一种即可。
 
 ## 支持的能力
 
-| 模块 | 可用操作 | 示例 |
-|------|----------|------|
-| 项目 | 查询项目信息、项目列表、成员列表 | "查看我参与的项目" |
-| 需求 | 查询 / 创建 / 更新需求，统计数量 | "创建需求：用户登录功能" |
-| 缺陷 | 查询 / 创建 / 更新缺陷，统计数量 | "查看我的未解决 Bug" |
-| 任务 | 查询 / 创建 / 更新任务，统计数量 | "把任务标记为已完成" |
-| 迭代 | 查询 / 创建 / 更新迭代，统计数量 | "当前迭代还有多少未完成" |
-| 工时 | 查询工时记录、录入工时、统计 | "录入 4 小时工时" |
-| 评论 | 查询和创建评论 | "给这个 Bug 加评论" |
-| 工作流 | 查询状态流转规则 | "需求有哪些状态" |
-| 配置 | 查询模块、版本、特性 | "项目有哪些模块" |
-| 测试 | 查询测试用例和测试计划 | "查看测试计划" |
-| Wiki | 查询项目文档 | "查看项目 Wiki" |
-| 发布 | 查询发布计划 | "查看发布计划" |
-| 用户 | 查询个人设置和角色 | "我的角色是什么" |
-
-共 **36 个工具**，覆盖 **13 个模块**。AI 助手会根据你的自然语言描述自动选择合适的工具。
+| 模块 | 工具数 | 可用操作 |
+|------|--------|----------|
+| 需求 | 28 | 查询/创建/更新/复制/批量更新需求；需求分类管理；工作项类型转换；字段信息查询；模板管理；关联缺陷/测试用例；时间关系管理 |
+| 测试 | 28 | 测试用例 CRUD；测试用例分类；测试计划 CRUD；测试执行与结果；用例与计划关联管理 |
+| 缺陷 | 20 | 查询/创建/更新/复制/批量更新缺陷；缺陷关联管理；字段信息查询；模板管理；变更历史 |
+| 项目配置 | 21 | 模块/版本/特性/基线 CRUD；自定义字段配置；项目配置开关 |
+| Wiki | 11 | 查询/创建/更新 Wiki 页面；附件/DrawIO/权限/关注者/标签管理 |
+| 发布 | 11 | 发布计划 CRUD；发布评审创建与管理；评审依据管理；模板查询 |
+| 项目 | 9 | 项目信息查询；成员列表；子项目；文档；日历；自定义字段；第三方项目关联 |
+| 任务 | 7 | 查询/创建/更新/批量更新任务；任务变更历史 |
+| 迭代 | 7 | 查询/创建/更新迭代；迭代变更历史；锁定/解锁 |
+| 工作流 | 7 | 工作流定义查询；状态映射；节点信息；转换规则；首末步骤查询 |
+| 自定义字段 | 7 | 需求/缺陷/任务/测试用例/迭代自定义字段配置查询；字段信息查询 |
+| 轻量级项目 | 6 | 轻量级工作项查询/创建/更新；分类管理；变更历史 |
+| 附件 | 5 | 附件查询/下载；轻量级项目附件管理 |
+| 工时 | 5 | 工时记录查询/创建/更新/删除；工时统计 |
+| 评论 | 4 | 评论查询/创建/更新；评论数量统计 |
+| 用户 | 4 | 个人设置查询；角色列表；第三方用户映射；当前用户信息 |
+| 变更历史 | 4 | 需求/任务变更历史查询；变更数量统计 |
+| 看板 | 4 | 看板工作项创建/查询/更新；看板列查询 |
+| 关联关系 | 4 | 需求关联查询/添加/删除；关联缺陷查询 |
+| 工具类 | 4 | 短ID转长ID；批量获取需求/缺陷/任务详情 |
+| 代码 | 3 | 代码提交记录添加/查询；提交对象详情 |
+| 轻量级项目空间 | 3 | 项目信息查询；成员列表；用户项目列表 |
+| 轻量级评论 | 3 | 评论查询/创建；评论数量统计 |
+| 报表 | 2 | 项目报表列表；状态流转时间统计 |
+| 项目集 | 2 | 项目集关联项目；项目集绑定实体 |
+| 图片 | 1 | 获取图片 URL |
+
+共 **210 个工具**，覆盖 **26 个模块**。AI 助手会根据你的自然语言描述自动选择合适的工具。
 
 ## 常见问题
 
@@ -134,6 +153,14 @@ claude mcp remove tapd
 
 在 TAPD 开放平台检查应用权限，确保已勾选所需 API 的访问权限。
 
+### 创建任务时提示权限不足
+
+如果 OAuth Token 没有 `tasks::create` 权限，可以通过 `tapd_create_story` 工具传入 TASK 类型的 `workitem_type_id` 来创建任务（仅需 `stories::create` 权限）：
+
+> 用 tapd_create_story 创建一个任务，workitem_type_id 设为 TASK 类型
+
+可通过 `tapd_get_workitem_types` 查询项目中可用的 TASK 类型 ID。
+
 ### 支持 Basic Auth 吗
 
 支持。设置 `TAPD_API_USER` 和 `TAPD_API_PASSWORD` 即可，与 Access Token 二选一。
@@ -152,7 +179,9 @@ claude mcp add -s user tapd \
   --env TAPD_ACCESS_TOKEN=your_access_token \
   --env TAPD_DEFAULT_WORKSPACE_ID=your_workspace_id \
   --env TAPD_NICK_NAME=your_nick_name \
-  -- npx -y "@xihe-lab/tapd-mcp-server"
+  --env TAPD_DEFAULT_TASK_WORKITEM_TYPE_ID=your_task_type_id \
+  --env TAPD_DEFAULT_STORY_WORKITEM_TYPE_ID=your_story_type_id \
+  -- npx -y "@xihe-lab/tapd-mcp-server@latest"
 ```
 
 ### Claude Desktop / Cursor
@@ -171,10 +200,43 @@ claude mcp add -s user tapd \
 }
 ```
 
-### 查看当前版本
+### npm 全局安装方式
+
+如果通过 npm 全局安装使用：
 
 ```bash
+# 查看当前安装版本
+npm list -g @xihe-lab/tapd-mcp-server
+
+# 更新到最新版本
+npm update -g @xihe-lab/tapd-mcp-server
+
+# 或指定版本安装
+npm install -g @xihe-lab/tapd-mcp-server@1.5.0
+```
+
+更新后需重启 MCP 客户端。
+
+### npx 缓存清理
+
+如果 npx 使用了旧版本缓存，可手动清理后重新运行：
+
+```bash
+# 清理 npx 缓存
+npx clear-npx-cache
+
+# 或手动删除缓存目录
+rm -rf ~/.npm/_npx
+```
+
+### 查看版本信息
+
+```bash
+# 查看最新发布版本
 npm view @xihe-lab/tapd-mcp-server version
+
+# 查看所有已发布版本
+npm view @xihe-lab/tapd-mcp-server versions
 ```
 
 ### 查看更新日志

package/dist/integration-test.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Integration Test Script for Tasks 210-213
+ *
+ * Tests:
+ * - Task 210: tapd_get_image_url
+ * - Task 212: tapd_get_current_user
+ * - Task 213: batch fetch functionality
+ */
+export {};
+//# sourceMappingURL=integration-test.d.ts.map

package/dist/integration-test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"integration-test.d.ts","sourceRoot":"","sources":["../src/integration-test.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/integration-test.js

@@ -0,0 +1,117 @@
+/**
+ * Integration Test Script for Tasks 210-213
+ *
+ * Tests:
+ * - Task 210: tapd_get_image_url
+ * - Task 212: tapd_get_current_user
+ * - Task 213: batch fetch functionality
+ */
+import { TapdClient } from './tapd-client.js';
+async function runTests() {
+    console.log('Starting integration tests...\n');
+    const client = TapdClient.fromEnv();
+    const workspaceId = TapdClient.getDefaultWorkspaceId();
+    if (!workspaceId) {
+        console.error('ERROR: TAPD_DEFAULT_WORKSPACE_ID must be set');
+        process.exit(1);
+    }
+    const results = [];
+    // Test 212: tapd_get_current_user
+    console.log('Test 212: tapd_get_current_user');
+    try {
+        const user = await client.get('/users/info');
+        console.log('  Result:', JSON.stringify(user, null, 2).slice(0, 200));
+        results.push({ test: 'tapd_get_current_user', status: 'PASS' });
+    }
+    catch (error) {
+        const msg = error instanceof Error ? error.message : String(error);
+        console.log('  Error:', msg);
+        results.push({ test: 'tapd_get_current_user', status: 'FAIL', error: msg });
+    }
+    // Test 210: tapd_get_image_url
+    console.log('\nTest 210: tapd_get_image_url');
+    try {
+        // Test with a sample image path
+        const testImagePath = '/tfl/captures/2025/04/test.png';
+        const imageUrl = await client.get('/files/get_image', {
+            workspace_id: workspaceId,
+            image_path: testImagePath,
+        });
+        console.log('  Result:', JSON.stringify(imageUrl, null, 2).slice(0, 200));
+        results.push({ test: 'tapd_get_image_url', status: 'PASS' });
+    }
+    catch (error) {
+        const msg = error instanceof Error ? error.message : String(error);
+        console.log('  Error:', msg);
+        // Expected to fail for non-existent image, but API should respond correctly
+        if (msg.includes('TAPD API error')) {
+            results.push({ test: 'tapd_get_image_url', status: 'PASS' }); // API responded correctly
+        }
+        else {
+            results.push({ test: 'tapd_get_image_url', status: 'FAIL', error: msg });
+        }
+    }
+    // Test 213: batch fetch stories
+    console.log('\nTest 213: tapd_batch_fetch_stories');
+    try {
+        // Test with a single known story ID
+        const testIds = ['1']; // Short ID test
+        const promises = testIds.map(id => client.get('/stories', {
+            workspace_id: workspaceId,
+            id: TapdClient.toLongId(id, workspaceId),
+        }));
+        const stories = await Promise.all(promises);
+        console.log('  Fetched stories count:', stories.length);
+        results.push({ test: 'tapd_batch_fetch_stories', status: 'PASS' });
+    }
+    catch (error) {
+        const msg = error instanceof Error ? error.message : String(error);
+        console.log('  Error:', msg);
+        results.push({ test: 'tapd_batch_fetch_stories', status: 'FAIL', error: msg });
+    }
+    // Test 213: batch fetch bugs
+    console.log('\nTest 213: tapd_batch_fetch_bugs');
+    try {
+        const testIds = ['1'];
+        const promises = testIds.map(id => client.get('/bugs', {
+            workspace_id: workspaceId,
+            id: TapdClient.toLongId(id, workspaceId),
+        }));
+        const bugs = await Promise.all(promises);
+        console.log('  Fetched bugs count:', bugs.length);
+        results.push({ test: 'tapd_batch_fetch_bugs', status: 'PASS' });
+    }
+    catch (error) {
+        const msg = error instanceof Error ? error.message : String(error);
+        console.log('  Error:', msg);
+        results.push({ test: 'tapd_batch_fetch_bugs', status: 'FAIL', error: msg });
+    }
+    // Test 213: batch fetch tasks
+    console.log('\nTest 213: tapd_batch_fetch_tasks');
+    try {
+        const testIds = ['1'];
+        const promises = testIds.map(id => client.get('/tasks', {
+            workspace_id: workspaceId,
+            id: TapdClient.toLongId(id, workspaceId),
+        }));
+        const tasks = await Promise.all(promises);
+        console.log('  Fetched tasks count:', tasks.length);
+        results.push({ test: 'tapd_batch_fetch_tasks', status: 'PASS' });
+    }
+    catch (error) {
+        const msg = error instanceof Error ? error.message : String(error);
+        console.log('  Error:', msg);
+        results.push({ test: 'tapd_batch_fetch_tasks', status: 'FAIL', error: msg });
+    }
+    // Summary
+    console.log('\n=== Test Summary ===');
+    const passed = results.filter(r => r.status === 'PASS').length;
+    const failed = results.filter(r => r.status === 'FAIL').length;
+    console.log(`Total: ${results.length}, PASS: ${passed}, FAIL: ${failed}`);
+    for (const r of results) {
+        console.log(`  ${r.status}: ${r.test}${r.error ? ` - ${r.error.slice(0, 100)}` : ''}`);
+    }
+    process.exit(failed > 0 ? 1 : 0);
+}
+runTests();
+//# sourceMappingURL=integration-test.js.map

package/dist/integration-test.js.map

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

package/dist/tapd-client.d.ts

@@ -32,8 +32,39 @@ export declare class TapdClient {
      */
     static getNickName(): string | undefined;
     /**
-     * Make HTTP request to TAPD API
+     * Get default workspace ID from environment variable TAPD_DEFAULT_WORKSPACE_ID
      */
+    static getDefaultWorkspaceId(): number | undefined;
+    /**
+     * Get default STORY workitem type ID from environment variable
+     */
+    static getDefaultStoryWorkitemTypeId(): string | undefined;
+    /**
+     * Get default TASK workitem type ID from environment variable
+     */
+    static getDefaultTaskWorkitemTypeId(): string | undefined;
+    /**
+     * Convert short ID to long ID
+     *
+     * Rules:
+     * - Pure numeric ID with ≤9 digits is treated as short ID
+     * - For cloud environment (is_cloud=true), prefix is '11'
+     * - Pad short ID to 9 digits and concatenate with workspace_id
+     * - Non-short IDs are returned unchanged
+     *
+     * @param id - Story/bug/task ID (short or long format)
+     * @param workspaceId - Workspace ID for constructing long ID
+     * @param isCloud - Whether it's cloud environment (default: true)
+     */
+    static toLongId(id: string | number, workspaceId: string | number, isCloud?: boolean): string;
+    /**
+   * Make HTTP request to TAPD API with retry support
+   *
+   * Retry policy:
+   * - Retry on 429/500/502/503 status codes
+   * - Max 3 retries with exponential backoff (1s, 2s, 4s)
+   * - POST requests do NOT retry (avoid duplicate creation)
+   */
     request<T>(method: 'GET' | 'POST', path: string, params?: Record<string, string | number | boolean | undefined>): Promise<T>;
     /**
      * GET request to TAPD API

package/dist/tapd-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tapd-client.d.ts","sourceRoot":"","sources":["../src/tapd-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAoB;IACpC,OAAO,CAAC,OAAO,CAAC,CAAS;IACzB,OAAO,CAAC,WAAW,CAAC,CAAS;IAE7B,OAAO;IAcP;;OAEG;IACH,MAAM,CAAC,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,UAAU;IAIzE;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,UAAU;IAWxF;;;OAGG;IACH,MAAM,CAAC,OAAO,IAAI,UAAU;IAmB5B;;OAEG;IACH,MAAM,CAAC,WAAW,IAAI,MAAM,GAAG,SAAS;IAIxC;;OAEG;IACG,OAAO,CAAC,CAAC,EACb,MAAM,EAAE,KAAK,GAAG,MAAM,EACtB,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,GAC7D,OAAO,CAAC,CAAC,CAAC;IAiDb;;OAEG;IACG,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAI1F;;OAEG;IACG,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;CAGxG;AAED;;GAEG;AACH,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,CAAC,CAAC;IACR,IAAI,EAAE,MAAM,CAAC;CACd"}
+{"version":3,"file":"tapd-client.d.ts","sourceRoot":"","sources":["../src/tapd-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAoB;IACpC,OAAO,CAAC,OAAO,CAAC,CAAS;IACzB,OAAO,CAAC,WAAW,CAAC,CAAS;IAE7B,OAAO;IAcP;;OAEG;IACH,MAAM,CAAC,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,UAAU;IAIzE;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,UAAU;IAWxF;;;OAGG;IACH,MAAM,CAAC,OAAO,IAAI,UAAU;IAmB5B;;OAEG;IACH,MAAM,CAAC,WAAW,IAAI,MAAM,GAAG,SAAS;IAIxC;;OAEG;IACH,MAAM,CAAC,qBAAqB,IAAI,MAAM,GAAG,SAAS;IAKlD;;OAEG;IACH,MAAM,CAAC,6BAA6B,IAAI,MAAM,GAAG,SAAS;IAI1D;;OAEG;IACH,MAAM,CAAC,4BAA4B,IAAI,MAAM,GAAG,SAAS;IAIzD;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,OAAO,GAAE,OAAc,GAAG,MAAM;IAcnG;;;;;;;KAOC;IACK,OAAO,CAAC,CAAC,EACb,MAAM,EAAE,KAAK,GAAG,MAAM,EACtB,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,GAC7D,OAAO,CAAC,CAAC,CAAC;IAkFb;;OAEG;IACG,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAI1F;;OAEG;IACG,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;CAGxG;AAED;;GAEG;AACH,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,CAAC,CAAC;IACR,IAAI,EAAE,MAAM,CAAC;CACd"}

package/dist/tapd-client.js

@@ -57,8 +57,56 @@ export class TapdClient {
         return process.env.TAPD_NICK_NAME;
     }
     /**
-     * Make HTTP request to TAPD API
+     * Get default workspace ID from environment variable TAPD_DEFAULT_WORKSPACE_ID
      */
+    static getDefaultWorkspaceId() {
+        const id = process.env.TAPD_DEFAULT_WORKSPACE_ID;
+        return id ? parseInt(id, 10) : undefined;
+    }
+    /**
+     * Get default STORY workitem type ID from environment variable
+     */
+    static getDefaultStoryWorkitemTypeId() {
+        return process.env.TAPD_DEFAULT_STORY_WORKITEM_TYPE_ID;
+    }
+    /**
+     * Get default TASK workitem type ID from environment variable
+     */
+    static getDefaultTaskWorkitemTypeId() {
+        return process.env.TAPD_DEFAULT_TASK_WORKITEM_TYPE_ID;
+    }
+    /**
+     * Convert short ID to long ID
+     *
+     * Rules:
+     * - Pure numeric ID with ≤9 digits is treated as short ID
+     * - For cloud environment (is_cloud=true), prefix is '11'
+     * - Pad short ID to 9 digits and concatenate with workspace_id
+     * - Non-short IDs are returned unchanged
+     *
+     * @param id - Story/bug/task ID (short or long format)
+     * @param workspaceId - Workspace ID for constructing long ID
+     * @param isCloud - Whether it's cloud environment (default: true)
+     */
+    static toLongId(id, workspaceId, isCloud = true) {
+        const idStr = String(id).trim();
+        const workspaceIdStr = String(workspaceId);
+        // Check if it's a pure numeric short ID (≤9 digits)
+        if (/^\d+$/.test(idStr) && idStr.length <= 9) {
+            const prefix = isCloud ? '11' : '10';
+            const paddedId = idStr.padStart(9, '0');
+            return `${prefix}${workspaceIdStr}${paddedId}`;
+        }
+        return idStr;
+    }
+    /**
+   * Make HTTP request to TAPD API with retry support
+   *
+   * Retry policy:
+   * - Retry on 429/500/502/503 status codes
+   * - Max 3 retries with exponential backoff (1s, 2s, 4s)
+   * - POST requests do NOT retry (avoid duplicate creation)
+   */
     async request(method, path, params) {
         const url = new URL(path, this.baseUrl);
         const headers = {
@@ -77,25 +125,54 @@ export class TapdClient {
                 .filter(([, value]) => value !== undefined)
                 .map(([key, value]) => [key, String(value).replace(/\\n/g, '\n')])).toString();
         }
-        const response = await fetch(url.toString(), {
-            method,
-            headers,
-            body,
-        });
-        if (!response.ok) {
-            const errorText = await response.text();
-            throw new Error(`TAPD API error: ${response.status} ${response.statusText} - ${errorText.slice(0, 200)}`);
-        }
-        const contentType = response.headers.get('content-type');
-        if (!contentType?.includes('application/json')) {
-            const text = await response.text();
-            throw new Error(`TAPD API returned non-JSON response: ${text.slice(0, 100)}`);
-        }
-        const result = await response.json();
-        if (result.status !== 1) {
-            throw new Error(`TAPD API error: ${result.info ?? 'Unknown error'}`);
+        // Retry configuration
+        const maxRetries = 3;
+        const retryableStatusCodes = [429, 500, 502, 503];
+        const shouldRetry = method === 'GET'; // Only retry GET requests
+        let lastError;
+        for (let attempt = 0; attempt <= maxRetries; attempt++) {
+            try {
+                const response = await fetch(url.toString(), {
+                    method,
+                    headers,
+                    body,
+                });
+                if (!response.ok) {
+                    const errorText = await response.text();
+                    const error = new Error(`TAPD API error: ${response.status} ${response.statusText} - ${errorText.slice(0, 200)}`);
+                    // Check if we should retry
+                    if (shouldRetry && retryableStatusCodes.includes(response.status) && attempt < maxRetries) {
+                        lastError = error;
+                        const delayMs = Math.pow(2, attempt) * 1000; // 1s, 2s, 4s
+                        await new Promise(resolve => setTimeout(resolve, delayMs));
+                        continue;
+                    }
+                    throw error;
+                }
+                const contentType = response.headers.get('content-type');
+                if (!contentType?.includes('application/json')) {
+                    const text = await response.text();
+                    throw new Error(`TAPD API returned non-JSON response: ${text.slice(0, 100)}`);
+                }
+                const result = await response.json();
+                if (result.status !== 1) {
+                    throw new Error(`TAPD API error: ${result.info ?? 'Unknown error'}`);
+                }
+                return result.data;
+            }
+            catch (error) {
+                // For non-retryable errors or final attempt, throw immediately
+                if (!shouldRetry || attempt >= maxRetries) {
+                    throw error;
+                }
+                // For network errors, retry
+                lastError = error instanceof Error ? error : new Error(String(error));
+                const delayMs = Math.pow(2, attempt) * 1000;
+                await new Promise(resolve => setTimeout(resolve, delayMs));
+            }
         }
-        return result.data;
+        // All retries exhausted
+        throw lastError ?? new Error('Request failed after all retries');
     }
     /**
      * GET request to TAPD API

package/dist/tapd-client.js.map

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

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

@@ -1 +1 @@
-{"version":3,"file":"attachment.d.ts","sourceRoot":"","sources":["../../src/tools/attachment.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,eAAO,MAAM,eAAe,EAAE,OAAO,EAuEpC,CAAC"}
+{"version":3,"file":"attachment.d.ts","sourceRoot":"","sources":["../../src/tools/attachment.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAG3C,eAAO,MAAM,eAAe,EAAE,OAAO,EA+FpC,CAAC"}

package/dist/tools/attachment.js

@@ -1,45 +1,62 @@
 import { z } from 'zod';
+import { TapdClient } from '../tapd-client.js';
 export const attachmentTools = [
     // Standard TAPD API attachment tools
     {
         name: 'tapd_get_attachments',
         description: 'Get attachment list from TAPD',
         inputSchema: z.object({
-            workspace_id: z.number().describe('Project ID (required)'),
+            workspace_id: z.number().optional().describe('项目ID（可省略，使用默认配置）'),
             id: z.string().optional().describe('Attachment ID, supports multiple IDs'),
             entity_id: z.string().optional().describe('Related entity ID (story/task/bug/wiki ID)'),
             entity_type: z.string().optional().describe('Entity type (story, task, bug, wiki)'),
+            filename: z.string().optional().describe('Filename'),
+            owner: z.string().optional().describe('Uploader'),
+            created: z.string().optional().describe('Creation time, supports time query'),
+            modified: z.string().optional().describe('Last modification time, supports time query'),
             fields: z.string().optional().describe('Comma-separated list of fields to return'),
             limit: z.number().optional().describe('Number of results to return, max 200'),
             page: z.number().optional().describe('Page number, default 1'),
             order: z.string().optional().describe('Sort order, e.g., "created desc"'),
         }),
         handler: async (client, params) => {
-            return client.get('/attachments', 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('/attachments', { ...params, workspace_id: workspaceId });
         },
     },
     {
         name: 'tapd_get_attachment',
         description: 'Get a single attachment from TAPD',
         inputSchema: z.object({
-            workspace_id: z.number().describe('Project ID (required)'),
+            workspace_id: z.number().optional().describe('项目ID（可省略，使用默认配置）'),
             id: z.string().describe('Attachment ID (required)'),
             fields: z.string().optional().describe('Comma-separated list of fields to return'),
         }),
         handler: async (client, params) => {
-            return client.get('/attachments/get_one', 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('/attachments/get_one', { ...params, workspace_id: workspaceId });
         },
     },
     {
         name: 'tapd_get_attachment_download_url',
         description: 'Get download URL for a single attachment (valid for 300s)',
         inputSchema: z.object({
-            workspace_id: z.number().describe('Project ID (required)'),
+            workspace_id: z.number().optional().describe('项目ID（可省略，使用默认配置）'),
             id: z.string().describe('Attachment ID (required)'),
             filename: z.string().optional().describe('Filename for download'),
         }),
         handler: async (client, params) => {
-            return client.get('/attachments/documents_down', 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('/attachments/documents_down', { ...params, workspace_id: workspaceId });
         },
     },
     // Mini (轻协作) API attachment tools
@@ -47,7 +64,7 @@ export const attachmentTools = [
         name: 'tapd_mini_get_attachments',
         description: 'Get attachments from mini workspace',
         inputSchema: z.object({
-            workspace_id: z.number().describe('Mini workspace ID (required)'),
+            workspace_id: z.number().optional().describe('项目ID（可省略，使用默认配置）'),
             id: z.string().optional().describe('Attachment ID'),
             entry_id: z.string().optional().describe('Item ID'),
             filename: z.string().optional().describe('Filename'),
@@ -56,18 +73,26 @@ export const attachmentTools = [
             page: z.number().optional().describe('Page number, default 1'),
         }),
         handler: async (client, params) => {
-            return client.get('/attachments', 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('/attachments', { ...params, workspace_id: workspaceId });
         },
     },
     {
         name: 'tapd_mini_get_attachment_download_url',
         description: 'Get download URL for a single mini workspace attachment (valid for 300s)',
         inputSchema: z.object({
-            workspace_id: z.number().describe('Mini workspace ID (required)'),
+            workspace_id: z.number().optional().describe('项目ID（可省略，使用默认配置）'),
             id: z.string().describe('Attachment ID (required)'),
         }),
         handler: async (client, params) => {
-            return client.get('/attachments/down', 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('/attachments/down', { ...params, workspace_id: workspaceId });
         },
     },
 ];