tapd-mcp 1.0.0

package/dist/index.js

@@ -0,0 +1,777 @@
+#!/usr/bin/env node
+/**
+ * TAPD MCP Server - Model Context Protocol server for TAPD operations
+ *
+ * Supports: Stories, Tasks, Bugs, Iterations, Comments, Releases
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { TapdClient } from './tapd-client.js';
+const API_TOKEN = process.env.TAPD_API_TOKEN;
+const DEFAULT_WORKSPACE_ID = process.env.TAPD_WORKSPACE_ID;
+const CURRENT_USER = process.env.TAPD_CURRENT_USER;
+if (!API_TOKEN) {
+    console.error('Error: TAPD_API_TOKEN environment variable is required');
+    console.error('Get your token from: https://www.tapd.cn/tapd_api_token/token');
+    process.exit(1);
+}
+const client = new TapdClient({ apiToken: API_TOKEN });
+const tools = [
+    // ==================== Story Tools ====================
+    {
+        name: 'tapd_get_story',
+        description: 'Get details of a specific story/requirement by ID or URL. ' +
+            'By default returns only id/name/status to keep responses small; ' +
+            'use the `fields` parameter to request more fields, or `fields="*"` for everything.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                workspace_id: { type: 'string', description: 'Workspace ID (optional if URL provided or default set)' },
+                story_id: { type: 'string', description: 'Story ID' },
+                url: { type: 'string', description: 'TAPD story URL (alternative to workspace_id + story_id)' },
+                fields: {
+                    type: 'string',
+                    description: 'Comma-separated field list to return, e.g. "id,name,status,owner,priority,description,iteration_id,created". ' +
+                        'Default: "id,name,status". Use "*" to return all TAPD fields (~260, response will be very large).',
+                },
+            },
+        },
+    },
+    {
+        name: 'tapd_list_stories',
+        description: 'List stories in a workspace with optional filters. ' +
+            'By default each story only contains id/name/status; pass `fields` to request more.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                workspace_id: { type: 'string', description: 'Workspace ID' },
+                iteration_id: { type: 'string', description: 'Filter by iteration ID' },
+                status: { type: 'string', description: 'Filter by status (planning, developing, testing, resolved, closed)' },
+                owner: { type: 'string', description: 'Filter by owner name' },
+                creator: { type: 'string', description: 'Filter by creator name' },
+                limit: { type: 'number', description: 'Max results (default 30)' },
+                page: { type: 'number', description: 'Page number (default 1)' },
+                fields: {
+                    type: 'string',
+                    description: 'Comma-separated fields per item. Default: "id,name,status". Use "*" for all fields.',
+                },
+            },
+            required: ['workspace_id'],
+        },
+    },
+    {
+        name: 'tapd_create_story',
+        description: 'Create a new story/requirement',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                workspace_id: { type: 'string', description: 'Workspace ID' },
+                name: { type: 'string', description: 'Story title' },
+                description: { type: 'string', description: 'Story description (supports HTML)' },
+                owner: { type: 'string', description: 'Owner name(s), semicolon separated' },
+                priority: { type: 'string', description: 'Priority (1-4, 1=highest)' },
+                iteration_id: { type: 'string', description: 'Iteration ID' },
+                parent_id: { type: 'string', description: 'Parent story ID' },
+                begin: { type: 'string', description: 'Start date (YYYY-MM-DD)' },
+                due: { type: 'string', description: 'Due date (YYYY-MM-DD)' },
+                category_id: { type: 'string', description: 'Category ID' },
+                release_id: { type: 'string', description: 'Release ID' },
+            },
+            required: ['workspace_id', 'name'],
+        },
+    },
+    {
+        name: 'tapd_update_story',
+        description: 'Update an existing story/requirement',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                workspace_id: { type: 'string', description: 'Workspace ID' },
+                story_id: { type: 'string', description: 'Story ID to update' },
+                name: { type: 'string', description: 'New title' },
+                description: { type: 'string', description: 'New description' },
+                owner: { type: 'string', description: 'New owner(s)' },
+                status: { type: 'string', description: 'New status' },
+                priority: { type: 'string', description: 'New priority' },
+                iteration_id: { type: 'string', description: 'New iteration ID' },
+                begin: { type: 'string', description: 'New start date' },
+                due: { type: 'string', description: 'New due date' },
+            },
+            required: ['workspace_id', 'story_id'],
+        },
+    },
+    // ==================== Task Tools ====================
+    {
+        name: 'tapd_get_task',
+        description: 'Get details of a specific task',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                workspace_id: { type: 'string', description: 'Workspace ID' },
+                task_id: { type: 'string', description: 'Task ID' },
+                url: { type: 'string', description: 'TAPD task URL' },
+            },
+        },
+    },
+    {
+        name: 'tapd_list_tasks',
+        description: 'List tasks, optionally filtered by story',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                workspace_id: { type: 'string', description: 'Workspace ID' },
+                story_id: { type: 'string', description: 'Filter by parent story ID' },
+                iteration_id: { type: 'string', description: 'Filter by iteration ID' },
+                status: { type: 'string', description: 'Filter by status (open, progressing, done)' },
+                owner: { type: 'string', description: 'Filter by owner' },
+                limit: { type: 'number', description: 'Max results' },
+                page: { type: 'number', description: 'Page number' },
+            },
+            required: ['workspace_id'],
+        },
+    },
+    {
+        name: 'tapd_create_task',
+        description: 'Create a new task under a story',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                workspace_id: { type: 'string', description: 'Workspace ID' },
+                name: { type: 'string', description: 'Task name' },
+                story_id: { type: 'string', description: 'Parent story ID' },
+                description: { type: 'string', description: 'Task description' },
+                owner: { type: 'string', description: 'Task owner' },
+                priority: { type: 'string', description: 'Priority' },
+                iteration_id: { type: 'string', description: 'Iteration ID' },
+                begin: { type: 'string', description: 'Start date' },
+                due: { type: 'string', description: 'Due date' },
+                effort: { type: 'string', description: 'Estimated effort (hours)' },
+            },
+            required: ['workspace_id', 'name'],
+        },
+    },
+    {
+        name: 'tapd_update_task',
+        description: 'Update a TAPD task. Supports status changes, work-hour tracking ' +
+            '(effort=estimated hours, effort_completed=spent hours, remain=remaining hours, ' +
+            'exceed=overrun hours, progress=completion %), reassignment, and date changes.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                workspace_id: { type: 'string', description: 'Workspace ID' },
+                task_id: { type: 'string', description: 'Task ID to update (required)' },
+                name: { type: 'string', description: 'New task name' },
+                description: { type: 'string', description: 'New description' },
+                owner: { type: 'string', description: 'Reassign to a user (or semicolon-separated list)' },
+                status: {
+                    type: 'string',
+                    description: 'Task status: open (未开始) | progressing (进行中) | done (已完成)',
+                },
+                priority: { type: 'string', description: 'Priority 1-4 (1=highest)' },
+                begin: { type: 'string', description: 'Start date YYYY-MM-DD' },
+                due: { type: 'string', description: 'Due date YYYY-MM-DD' },
+                effort: {
+                    type: 'string',
+                    description: 'Estimated total work hours, e.g. "8" or "8.5"',
+                },
+                effort_completed: {
+                    type: 'string',
+                    description: 'Hours already spent, e.g. "3.5"',
+                },
+                remain: {
+                    type: 'string',
+                    description: 'Hours remaining, e.g. "4.5". TAPD may auto-derive from effort - effort_completed; pass explicitly to override.',
+                },
+                exceed: {
+                    type: 'string',
+                    description: 'Hours exceeded beyond the original estimate, e.g. "1"',
+                },
+                progress: {
+                    type: 'string',
+                    description: 'Completion percentage 0-100, e.g. "50"',
+                },
+                iteration_id: { type: 'string', description: 'Move to a different iteration' },
+            },
+            required: ['workspace_id', 'task_id'],
+        },
+    },
+    // ==================== Bug Tools ====================
+    {
+        name: 'tapd_get_bug',
+        description: 'Get details of a specific bug',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                workspace_id: { type: 'string', description: 'Workspace ID' },
+                bug_id: { type: 'string', description: 'Bug ID' },
+                url: { type: 'string', description: 'TAPD bug URL' },
+            },
+        },
+    },
+    {
+        name: 'tapd_list_bugs',
+        description: 'List bugs with optional filters',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                workspace_id: { type: 'string', description: 'Workspace ID' },
+                iteration_id: { type: 'string', description: 'Filter by iteration' },
+                status: { type: 'string', description: 'Filter by status (new, in_progress, resolved, verified, closed, rejected, reopened)' },
+                severity: { type: 'string', description: 'Filter by severity' },
+                current_owner: { type: 'string', description: 'Filter by current owner' },
+                limit: { type: 'number', description: 'Max results' },
+                page: { type: 'number', description: 'Page number' },
+            },
+            required: ['workspace_id'],
+        },
+    },
+    {
+        name: 'tapd_create_bug',
+        description: 'Create a new bug report',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                workspace_id: { type: 'string', description: 'Workspace ID' },
+                title: { type: 'string', description: 'Bug title' },
+                description: { type: 'string', description: 'Bug description' },
+                current_owner: { type: 'string', description: 'Assignee' },
+                severity: { type: 'string', description: 'Severity (fatal, serious, normal, prompt, advice)' },
+                priority: { type: 'string', description: 'Priority' },
+                iteration_id: { type: 'string', description: 'Iteration ID' },
+                module: { type: 'string', description: 'Module name' },
+                version_test: { type: 'string', description: 'Test version' },
+                version_report: { type: 'string', description: 'Report version' },
+                bugtype: { type: 'string', description: 'Bug type' },
+            },
+            required: ['workspace_id', 'title'],
+        },
+    },
+    {
+        name: 'tapd_update_bug',
+        description: 'Update a bug',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                workspace_id: { type: 'string', description: 'Workspace ID' },
+                bug_id: { type: 'string', description: 'Bug ID' },
+                title: { type: 'string', description: 'New title' },
+                description: { type: 'string', description: 'New description' },
+                current_owner: { type: 'string', description: 'New owner' },
+                status: { type: 'string', description: 'New status' },
+                severity: { type: 'string', description: 'New severity' },
+                priority: { type: 'string', description: 'New priority' },
+            },
+            required: ['workspace_id', 'bug_id'],
+        },
+    },
+    // ==================== Iteration Tools ====================
+    {
+        name: 'tapd_get_iteration',
+        description: 'Get details of a specific iteration',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                workspace_id: { type: 'string', description: 'Workspace ID' },
+                iteration_id: { type: 'string', description: 'Iteration ID' },
+            },
+            required: ['workspace_id', 'iteration_id'],
+        },
+    },
+    {
+        name: 'tapd_list_iterations',
+        description: 'List iterations in a workspace',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                workspace_id: { type: 'string', description: 'Workspace ID' },
+                status: { type: 'string', description: 'Filter by status' },
+                limit: { type: 'number', description: 'Max results' },
+                page: { type: 'number', description: 'Page number' },
+            },
+            required: ['workspace_id'],
+        },
+    },
+    {
+        name: 'tapd_create_iteration',
+        description: 'Create a new iteration/sprint',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                workspace_id: { type: 'string', description: 'Workspace ID' },
+                name: { type: 'string', description: 'Iteration name' },
+                description: { type: 'string', description: 'Description' },
+                startdate: { type: 'string', description: 'Start date (YYYY-MM-DD)' },
+                enddate: { type: 'string', description: 'End date (YYYY-MM-DD)' },
+            },
+            required: ['workspace_id', 'name'],
+        },
+    },
+    {
+        name: 'tapd_update_iteration',
+        description: 'Update an iteration',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                workspace_id: { type: 'string', description: 'Workspace ID' },
+                iteration_id: { type: 'string', description: 'Iteration ID' },
+                name: { type: 'string', description: 'New name' },
+                description: { type: 'string', description: 'New description' },
+                startdate: { type: 'string', description: 'New start date' },
+                enddate: { type: 'string', description: 'New end date' },
+                status: { type: 'string', description: 'New status' },
+            },
+            required: ['workspace_id', 'iteration_id'],
+        },
+    },
+    // ==================== Comment Tools ====================
+    {
+        name: 'tapd_list_comments',
+        description: 'List comments on a story, task, or bug',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                workspace_id: { type: 'string', description: 'Workspace ID' },
+                entry_type: { type: 'string', enum: ['stories', 'tasks', 'bugs'], description: 'Type of item' },
+                entry_id: { type: 'string', description: 'ID of the story/task/bug' },
+                limit: { type: 'number', description: 'Max results' },
+                page: { type: 'number', description: 'Page number' },
+            },
+            required: ['workspace_id', 'entry_type', 'entry_id'],
+        },
+    },
+    {
+        name: 'tapd_add_comment',
+        description: 'Add a comment to a story, task, or bug',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                workspace_id: { type: 'string', description: 'Workspace ID' },
+                entry_type: { type: 'string', enum: ['stories', 'tasks', 'bugs'], description: 'Type of item' },
+                entry_id: { type: 'string', description: 'ID of the story/task/bug' },
+                description: { type: 'string', description: 'Comment content' },
+            },
+            required: ['workspace_id', 'entry_type', 'entry_id', 'description'],
+        },
+    },
+    // ==================== Release Tools ====================
+    {
+        name: 'tapd_list_releases',
+        description: 'List releases in a workspace',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                workspace_id: { type: 'string', description: 'Workspace ID' },
+                status: { type: 'string', description: 'Filter by status' },
+                limit: { type: 'number', description: 'Max results' },
+                page: { type: 'number', description: 'Page number' },
+            },
+            required: ['workspace_id'],
+        },
+    },
+    {
+        name: 'tapd_create_release',
+        description: 'Create a new release',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                workspace_id: { type: 'string', description: 'Workspace ID' },
+                name: { type: 'string', description: 'Release name' },
+                description: { type: 'string', description: 'Description' },
+                startdate: { type: 'string', description: 'Start date' },
+                enddate: { type: 'string', description: 'End date' },
+            },
+            required: ['workspace_id', 'name'],
+        },
+    },
+    {
+        name: 'tapd_update_release',
+        description: 'Update a release',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                workspace_id: { type: 'string', description: 'Workspace ID' },
+                release_id: { type: 'string', description: 'Release ID' },
+                name: { type: 'string', description: 'New name' },
+                description: { type: 'string', description: 'New description' },
+                startdate: { type: 'string', description: 'New start date' },
+                enddate: { type: 'string', description: 'New end date' },
+                status: { type: 'string', description: 'New status' },
+            },
+            required: ['workspace_id', 'release_id'],
+        },
+    },
+    // ==================== Code Relation Tools ====================
+    {
+        name: 'tapd_get_story_commits',
+        description: 'Get code commits associated with a story',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                workspace_id: { type: 'string', description: 'Workspace ID' },
+                story_id: { type: 'string', description: 'Story ID' },
+                limit: { type: 'number', description: 'Max results' },
+                page: { type: 'number', description: 'Page number' },
+            },
+            required: ['workspace_id', 'story_id'],
+        },
+    },
+    // ==================== Utility Tools ====================
+    {
+        name: 'tapd_parse_url',
+        description: 'Parse a TAPD URL to extract workspace ID, resource type, and resource ID',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                url: { type: 'string', description: 'TAPD URL to parse' },
+            },
+            required: ['url'],
+        },
+    },
+    {
+        name: 'tapd_get_current_user',
+        description: 'Get the current TAPD user (the "me" identity behind the API token). ' +
+            'Reads from the TAPD_CURRENT_USER env var as the source of truth. ' +
+            'When workspace_id is provided (or TAPD_WORKSPACE_ID is set), enriches the result ' +
+            'with name/email/role looked up via /users/get_users_by_workspace_id.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                workspace_id: {
+                    type: 'string',
+                    description: 'Optional workspace ID to enrich with member details. Falls back to TAPD_WORKSPACE_ID.',
+                },
+            },
+        },
+    },
+];
+function getWorkspaceId(args) {
+    const wsId = args.workspace_id;
+    if (wsId)
+        return wsId;
+    if (DEFAULT_WORKSPACE_ID)
+        return DEFAULT_WORKSPACE_ID;
+    throw new Error('workspace_id is required (or set TAPD_WORKSPACE_ID env var)');
+}
+/**
+ * Resolve the `fields` parameter for read tools.
+ * - undefined / empty => default minimal set 'id,name,status' (or caller-provided default)
+ * - '*' / 'all' => undefined (let TAPD return everything)
+ * - otherwise => trimmed comma string
+ *
+ * Returns both the api-bound string and a Set of requested field names so callers
+ * can decide whether to attach derived helpers (e.g. status_name).
+ */
+function resolveFields(args, defaultFields = 'id,name,status') {
+    const raw = args.fields?.trim();
+    if (raw === '*' || raw === 'all') {
+        return { fields: undefined, requested: new Set(), isAll: true };
+    }
+    const fields = raw && raw.length > 0 ? raw : defaultFields;
+    const requested = new Set(fields.split(',').map(f => f.trim()).filter(Boolean));
+    return { fields, requested, isAll: false };
+}
+async function handleToolCall(name, args) {
+    switch (name) {
+        // Story handlers
+        case 'tapd_get_story': {
+            const { fields, requested, isAll } = resolveFields(args);
+            const attachStatusName = (s) => s && (isAll || requested.has('status'))
+                ? { ...s, status_name: client.translateStoryStatus(s.status || '') }
+                : s;
+            if (args.url) {
+                const parsed = client.parseUrl(args.url);
+                if (!parsed)
+                    throw new Error('Invalid TAPD URL');
+                const story = await client.getStory(parsed.workspaceId, parsed.resourceId, fields);
+                return attachStatusName(story);
+            }
+            const wsId = getWorkspaceId(args);
+            const story = await client.getStory(wsId, args.story_id, fields);
+            return attachStatusName(story);
+        }
+        case 'tapd_list_stories': {
+            const { fields, requested, isAll } = resolveFields(args);
+            const stories = await client.listStories(getWorkspaceId(args), {
+                iterationId: args.iteration_id,
+                status: args.status,
+                owner: args.owner,
+                creator: args.creator,
+                limit: args.limit,
+                page: args.page,
+                fields,
+            });
+            const showStatus = isAll || requested.has('status');
+            return stories.map(s => showStatus ? { ...s, status_name: client.translateStoryStatus(s.status || '') } : s);
+        }
+        case 'tapd_create_story': {
+            return await client.createStory(getWorkspaceId(args), {
+                name: args.name,
+                description: args.description,
+                owner: args.owner,
+                priority: args.priority,
+                iterationId: args.iteration_id,
+                parentId: args.parent_id,
+                begin: args.begin,
+                due: args.due,
+                categoryId: args.category_id,
+                releaseId: args.release_id,
+            });
+        }
+        case 'tapd_update_story': {
+            return await client.updateStory(getWorkspaceId(args), args.story_id, {
+                name: args.name,
+                description: args.description,
+                owner: args.owner,
+                status: args.status,
+                priority: args.priority,
+                iterationId: args.iteration_id,
+                begin: args.begin,
+                due: args.due,
+            });
+        }
+        // Task handlers
+        case 'tapd_get_task': {
+            if (args.url) {
+                const parsed = client.parseUrl(args.url);
+                if (!parsed)
+                    throw new Error('Invalid TAPD URL');
+                const task = await client.getTask(parsed.workspaceId, parsed.resourceId);
+                return task ? { ...task, status_name: client.translateTaskStatus(task.status || '') } : null;
+            }
+            const wsId = getWorkspaceId(args);
+            const task = await client.getTask(wsId, args.task_id);
+            return task ? { ...task, status_name: client.translateTaskStatus(task.status || '') } : null;
+        }
+        case 'tapd_list_tasks': {
+            const tasks = await client.listTasks(getWorkspaceId(args), {
+                storyId: args.story_id,
+                iterationId: args.iteration_id,
+                status: args.status,
+                owner: args.owner,
+                limit: args.limit,
+                page: args.page,
+            });
+            return tasks.map(t => ({ ...t, status_name: client.translateTaskStatus(t.status || '') }));
+        }
+        case 'tapd_create_task': {
+            return await client.createTask(getWorkspaceId(args), {
+                name: args.name,
+                storyId: args.story_id,
+                description: args.description,
+                owner: args.owner,
+                priority: args.priority,
+                iterationId: args.iteration_id,
+                begin: args.begin,
+                due: args.due,
+                effort: args.effort,
+            });
+        }
+        case 'tapd_update_task': {
+            return await client.updateTask(getWorkspaceId(args), args.task_id, {
+                name: args.name,
+                description: args.description,
+                owner: args.owner,
+                status: args.status,
+                priority: args.priority,
+                begin: args.begin,
+                due: args.due,
+                effort: args.effort,
+                effortCompleted: args.effort_completed,
+                remain: args.remain,
+                exceed: args.exceed,
+                progress: args.progress,
+                iterationId: args.iteration_id,
+            });
+        }
+        // Bug handlers
+        case 'tapd_get_bug': {
+            if (args.url) {
+                const parsed = client.parseUrl(args.url);
+                if (!parsed)
+                    throw new Error('Invalid TAPD URL');
+                const bug = await client.getBug(parsed.workspaceId, parsed.resourceId);
+                return bug ? { ...bug, status_name: client.translateBugStatus(bug.status || '') } : null;
+            }
+            const wsId = getWorkspaceId(args);
+            const bug = await client.getBug(wsId, args.bug_id);
+            return bug ? { ...bug, status_name: client.translateBugStatus(bug.status || '') } : null;
+        }
+        case 'tapd_list_bugs': {
+            const bugs = await client.listBugs(getWorkspaceId(args), {
+                iterationId: args.iteration_id,
+                status: args.status,
+                severity: args.severity,
+                currentOwner: args.current_owner,
+                limit: args.limit,
+                page: args.page,
+            });
+            return bugs.map(b => ({ ...b, status_name: client.translateBugStatus(b.status || '') }));
+        }
+        case 'tapd_create_bug': {
+            return await client.createBug(getWorkspaceId(args), {
+                title: args.title,
+                description: args.description,
+                currentOwner: args.current_owner,
+                severity: args.severity,
+                priority: args.priority,
+                iterationId: args.iteration_id,
+                module: args.module,
+                versionTest: args.version_test,
+                versionReport: args.version_report,
+                bugtype: args.bugtype,
+            });
+        }
+        case 'tapd_update_bug': {
+            return await client.updateBug(getWorkspaceId(args), args.bug_id, {
+                title: args.title,
+                description: args.description,
+                currentOwner: args.current_owner,
+                status: args.status,
+                severity: args.severity,
+                priority: args.priority,
+            });
+        }
+        // Iteration handlers
+        case 'tapd_get_iteration': {
+            return await client.getIteration(getWorkspaceId(args), args.iteration_id);
+        }
+        case 'tapd_list_iterations': {
+            return await client.listIterations(getWorkspaceId(args), {
+                status: args.status,
+                limit: args.limit,
+                page: args.page,
+            });
+        }
+        case 'tapd_create_iteration': {
+            return await client.createIteration(getWorkspaceId(args), {
+                name: args.name,
+                description: args.description,
+                startdate: args.startdate,
+                enddate: args.enddate,
+            });
+        }
+        case 'tapd_update_iteration': {
+            return await client.updateIteration(getWorkspaceId(args), args.iteration_id, {
+                name: args.name,
+                description: args.description,
+                startdate: args.startdate,
+                enddate: args.enddate,
+                status: args.status,
+            });
+        }
+        // Comment handlers
+        case 'tapd_list_comments': {
+            return await client.listComments(getWorkspaceId(args), args.entry_type, args.entry_id, { limit: args.limit, page: args.page });
+        }
+        case 'tapd_add_comment': {
+            return await client.addComment(getWorkspaceId(args), args.entry_type, args.entry_id, args.description);
+        }
+        // Release handlers
+        case 'tapd_list_releases': {
+            return await client.listReleases(getWorkspaceId(args), {
+                status: args.status,
+                limit: args.limit,
+                page: args.page,
+            });
+        }
+        case 'tapd_create_release': {
+            return await client.createRelease(getWorkspaceId(args), {
+                name: args.name,
+                description: args.description,
+                startdate: args.startdate,
+                enddate: args.enddate,
+            });
+        }
+        case 'tapd_update_release': {
+            return await client.updateRelease(getWorkspaceId(args), args.release_id, {
+                name: args.name,
+                description: args.description,
+                startdate: args.startdate,
+                enddate: args.enddate,
+                status: args.status,
+            });
+        }
+        // Code relation handlers
+        case 'tapd_get_story_commits': {
+            return await client.getStoryCodeCommits(getWorkspaceId(args), args.story_id, { limit: args.limit, page: args.page });
+        }
+        // Utility handlers
+        case 'tapd_parse_url': {
+            const parsed = client.parseUrl(args.url);
+            if (!parsed)
+                throw new Error('Invalid TAPD URL format');
+            return parsed;
+        }
+        case 'tapd_get_current_user': {
+            if (!CURRENT_USER) {
+                throw new Error('TAPD_CURRENT_USER env var is not set. ' +
+                    'Set it to your TAPD user id (e.g. "xiaopeng_lei") in the MCP server config so I can identify "you".');
+            }
+            const base = { user: CURRENT_USER, source: 'env' };
+            const wsId = args.workspace_id || DEFAULT_WORKSPACE_ID;
+            if (wsId) {
+                try {
+                    const members = await client.getWorkspaceUsers(wsId);
+                    const match = members.find(m => m.user === CURRENT_USER || m.name === CURRENT_USER || m.nick === CURRENT_USER);
+                    if (match) {
+                        return { ...base, workspace_id: wsId, matched_in_workspace: true, ...match };
+                    }
+                    return { ...base, workspace_id: wsId, matched_in_workspace: false };
+                }
+                catch (e) {
+                    base.enrich_error = e instanceof Error ? e.message : String(e);
+                }
+            }
+            return base;
+        }
+        default:
+            throw new Error(`Unknown tool: ${name}`);
+    }
+}
+async function main() {
+    const server = new Server({
+        name: 'tapd-mcp',
+        version: '1.0.0',
+    }, {
+        capabilities: {
+            tools: {},
+        },
+    });
+    server.setRequestHandler(ListToolsRequestSchema, async () => ({
+        tools,
+    }));
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        try {
+            const result = await handleToolCall(request.params.name, (request.params.arguments || {}));
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify(result, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error: ${message}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error('TAPD MCP Server running on stdio');
+}
+main().catch((error) => {
+    console.error('Fatal error:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map