targetprocess-mcp-server 2.2.7 → 2.2.8

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)
             }],
     };
 });

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"],

package/package.json

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