targetprocess-mcp-server 2.2.7 → 2.2.9-b

package/README.md

@@ -45,6 +45,9 @@ Features
 - `get_feature_user_stories` — Get all user stories for a feature by its ID (id)
 - `get_not_covered_user_stories_in_feature` — Get user stories in a feature not yet covered by tests, includes `covered` field based on "Test Automation" custom field (id)
 
+User Stories
+- `get_user_story_bugs` — Get all bugs linked to a user story by its ID (id)
+
 Cards — Read
 - `get_card_current_status` — Get EntityState, TeamState, and assigned teams for a card (id, optional resourceType: UserStory | Bug | Feature, default: UserStory)
 - `get_bug_content` — Fetch full content of a bug by ID (id)

package/build/index.js

@@ -603,7 +603,7 @@ server.registerTool('create_bug_based_on_card', {
       CRITICAL WORKFLOW: Before calling this tool, you MUST follow these steps:
         1) IF you already have user story or bug card content, proceed to step 3 skipping step 2;
         2) ELSE call "get_user_story_content" tool or "get_bug_content" tool to get user story or bug card content;
-        3) format the new bug inside html <div> tags with Issue Description, Steps to Reproduce, Expected Behavior, Actual Behavior sections (note: section titles should be wrapped in <h3> tags, e.g. <h3>Issue Description</h3>);
+        3) format the new bug inside html <div> tags with Environment, Issue Description, Steps to Reproduce, Expected Behavior, Actual Behavior and Attachments sections (note: section titles should be wrapped in <h3> tags, e.g. <h3>Issue Description</h3>);
         4) IF the user specified a team by name (not ID), call "get_teams" to find the matching team and use its ID as teamId;
         5) IF the user specified a project by name (not ID), call "get_projects" to find the matching project and use its ID as projectId;
         6) add a comment to the card with created bug Id and its Title`,
@@ -771,7 +771,7 @@ server.registerTool('create_bug', {
     description: `Create a new bug card that summarizes the problem in concise, descriptive manner answering questions "What? Where? When?" and content explaining what happened in detail.
       NOTE: this tool does not require a user story or bug card reference.
       CRITICAL WORKFLOW: Before calling this tool, you MUST follow these steps:
-        1) format the new bug inside html <div> tags with Issue Description, Steps to Reproduce, Expected Behavior, Actual Behavior sections (note: section titles should be wrapped in <h3> tags, e.g. <h3>Issue Description</h3>, step to reproduce should be wrapped in <ol>);
+        1) format the new bug inside html <div> tags with Environment, Issue Description, Steps to Reproduce, Expected Behavior, Actual Behavior and Attachments sections (note: section titles should be wrapped in <h3> tags, e.g. <h3>Issue Description</h3>, step to reproduce should be wrapped in <ol>);
         2) IF the user specified a team by name (not ID), call "get_teams" to find the matching team and use its ID as teamId;
         3) IF the user specified a project by name (not ID), call "get_projects" to find the matching project and use its ID as projectId;`,
     inputSchema: {
@@ -1058,19 +1058,45 @@ server.registerTool('get_feature_user_stories', {
                 }],
         };
     }
-    const featureItems = items[0].items || [];
+    return {
+        content: [{
+                type: 'text',
+                text: JSON.stringify(items)
+            }],
+    };
+});
+server.registerTool('get_user_story_bugs', {
+    title: 'Get user story bugs',
+    description: 'Get bugs linked to a TP user story by its ID',
+    inputSchema: {
+        id: z.string()
+            .min(5)
+            .max(6)
+            .describe('TP user story ID (e.g. 145789)'),
+    },
+}, async ({ id }) => {
+    const response = await tp.getUserStoryBugs(id);
+    if (!response) {
+        return {
+            content: [{
+                    type: 'text',
+                    text: `Failed to get bugs for user story id: ${id}`
+                }],
+        };
+    }
+    const items = response.items || [];
     if (items.length === 0) {
         return {
             content: [{
                     type: 'text',
-                    text: `No user stories found for feature id: ${id}`,
+                    text: `No bugs found for user story id: ${id}`,
                 }],
         };
     }
     return {
         content: [{
                 type: 'text',
-                text: JSON.stringify(featureItems)
+                text: JSON.stringify(items)
             }],
     };
 });
@@ -1531,6 +1557,138 @@ server.registerTool('get_card_current_status', {
             }],
     };
 });
+server.registerTool('get_in_progress_tasks_and_bugs', {
+    title: 'Get in-progress tasks and bugs for a user',
+    description: 'Get all Tasks and Bugs currently in "In Progress" state assigned to a given user ID',
+    inputSchema: {
+        userId: z.string()
+            .describe('Targetprocess user ID (e.g. 123)'),
+    },
+}, async ({ userId }) => {
+    const result = await tp.getInProgressTasksAndBugs(userId);
+    const tasks = result.tasks.map((t) => ({
+        type: 'Task',
+        id: t.Id,
+        name: t.Name,
+        state: t.EntityState?.Name,
+        userStoryId: t.UserStory?.Id,
+        userStoryName: t.UserStory?.Name,
+        featureId: t.UserStory?.Feature?.Id,
+        featureName: t.UserStory?.Feature?.Name,
+    }));
+    const bugs = result.bugs.map((b) => ({
+        type: 'Bug',
+        id: b.Id,
+        name: b.Name,
+        state: b.EntityState?.Name,
+        userStoryId: b.UserStory?.Id,
+        userStoryName: b.UserStory?.Name,
+        featureId: b.UserStory?.Feature?.Id ?? b.Feature?.Id,
+        featureName: b.UserStory?.Feature?.Name ?? b.Feature?.Name,
+    }));
+    const items = [...tasks, ...bugs];
+    if (items.length === 0) {
+        return {
+            content: [{
+                    type: 'text',
+                    text: `No in-progress tasks or bugs found for user ID: ${userId}`,
+                }],
+        };
+    }
+    return {
+        content: [{
+                type: 'text',
+                text: JSON.stringify(items),
+            }],
+    };
+});
+server.registerTool('create_task', {
+    title: 'Create a new task',
+    description: 'Create a new task linked to a user story.',
+    inputSchema: {
+        title: z.string()
+            .describe('Task title'),
+        userStoryId: z.string()
+            .min(5)
+            .max(6)
+            .describe('User story ID to link the task to (e.g. 145789)'),
+        description: z.string()
+            .optional()
+            .describe('Task description (optional)'),
+    },
+}, async ({ title, userStoryId, description }) => {
+    const taskResponse = await tp.createTask({ title, userStoryId, description });
+    if (!taskResponse) {
+        return {
+            content: [{
+                    type: 'text',
+                    text: `Failed to create task "${title}"\n JSON: ${JSON.stringify(taskResponse, null, 2)}`
+                }]
+        };
+    }
+    return {
+        content: [{
+                type: 'text',
+                text: JSON.stringify(taskResponse)
+            }],
+    };
+});
+server.registerTool('get_commit_message', {
+    title: 'Get commit message for a task or bug',
+    description: `Returns the formatted commit message string for a given task or bug ID.
+Formats:
+- Task on a user story: "F#<featureId> US#<userStoryId> T#<taskId> <title>"
+- Bug on a user story: "F#<featureId> US#<userStoryId> B#<bugId> <title>"
+- Standalone bug (no user story): "B#<bugId> <title>"`,
+    inputSchema: {
+        id: z.string()
+            .describe('The task or bug ID (e.g. 145789)'),
+        type: z.enum(['task', 'bug'])
+            .describe('Whether the ID refers to a task or a bug'),
+    },
+}, async ({ id, type }) => {
+    if (type === 'task') {
+        const task = await tp.getTask(id);
+        if (!task) {
+            return {
+                content: [{ type: 'text', text: `Failed to get task with id: ${id}` }],
+            };
+        }
+        const userStory = task.UserStory;
+        const feature = userStory?.Feature;
+        if (!userStory) {
+            return {
+                content: [{ type: 'text', text: `Task ${id} has no linked user story` }],
+            };
+        }
+        const prefix = feature
+            ? `F#${feature.Id} US#${userStory.Id} T#${task.Id}`
+            : `US#${userStory.Id} T#${task.Id}`;
+        return {
+            content: [{ type: 'text', text: `${prefix} ${task.Name}` }],
+        };
+    }
+    // type === 'bug'
+    const bug = await tp.getBugWithRelations(id);
+    if (!bug) {
+        return {
+            content: [{ type: 'text', text: `Failed to get bug with id: ${id}` }],
+        };
+    }
+    const userStory = bug.UserStory;
+    const feature = userStory?.Feature ?? bug.Feature;
+    if (!userStory) {
+        return {
+            content: [{ type: 'text', text: `B#${bug.Id} ${bug.Name}` }],
+        };
+    }
+    const prefix = feature
+        ? `F#${feature.Id} US#${userStory.Id} B#${bug.Id}`
+        : `US#${userStory.Id} B#${bug.Id}`;
+    return {
+        content: [{ type: 'text', text: `${prefix} ${bug.Name}` }],
+    };
+});
 async function main() {
     const transport = new StdioServerTransport();
     await server.connect(transport);

package/build/tp.js

@@ -45,7 +45,6 @@ export class TpClient {
     async get(params) {
         params.param["access_token"] = this.token;
         let _url = this.params(params);
-        console.error(JSON.stringify({ "TP_URL": _url }, null, 2));
         try {
             const response = await fetch(_url, {
                 method: "GET",
@@ -457,6 +456,17 @@ export class TpClient {
             apiVersion: this.v2
         });
     }
+    async getUserStoryBugs(userStoryId) {
+        return this.get({
+            pathParam: ["userstories"],
+            param: {
+                "format": "json",
+                "where": `(id==${userStoryId})`,
+                "select": `{bugs}`,
+            },
+            apiVersion: this.v2
+        });
+    }
     async getUserStoriesIdsByFeatureId(featureId) {
         return this.get({
             pathParam: ["userstories"],
@@ -581,6 +591,57 @@ export class TpClient {
             param: { "format": "json" }
         });
     }
+    async getInProgressTasksAndBugs(userId) {
+        const where = `(EntityState.Name eq 'In Progress') and (AssignedUser.Id eq ${userId})`;
+        const include = "[Id,Name,EntityState[Name],UserStory[Id,Name,Feature[Id,Name]]]";
+        const param = { "format": "json", "where": where, "include": include, "orderByDesc": "ModifyDate" };
+        const [tasks, bugs] = await Promise.all([
+            this.get({ pathParam: ["Tasks"], param }),
+            this.get({ pathParam: ["Bugs"], param }),
+        ]);
+        return {
+            tasks: tasks?.Items ?? [],
+            bugs: bugs?.Items ?? [],
+        };
+    }
+    async getTask(taskId) {
+        const response = await this.get({
+            pathParam: ["Tasks", taskId],
+            param: {
+                "format": "json",
+                "include": "[Id,Name,UserStory[Id,Name,Feature[Id,Name]]]",
+            }
+        });
+        return response;
+    }
+    async getBugWithRelations(bugId) {
+        const response = await this.get({
+            pathParam: ["Bugs", bugId],
+            param: {
+                "format": "json",
+                "include": "[Id,Name,UserStory[Id,Name,Feature[Id,Name]]]",
+            }
+        });
+        return response;
+    }
+    async createTask({ title, description, userStoryId }) {
+        const task = {
+            "Name": title,
+            "Project": {
+                "Id": config.tp.projectId
+            },
+            "UserStory": {
+                "Id": userStoryId
+            },
+        };
+        if (description) {
+            task["Description"] = description;
+        }
+        return this.post({
+            pathParam: ["Tasks"],
+            param: { "format": "json" },
+        }, task);
+    }
     async addAttachedFile(generalId, source) {
         let blob;
         let fileName;

package/package.json

@@ -25,7 +25,7 @@
   "engines": {
     "node": ">=20.x"
   },
-  "version": "2.2.7",
+  "version": "2.2.9b",
   "description": "MCP server for Tartget Process",
   "main": "build/index.js",
   "keywords": [