targetprocess-mcp-server 2.0.3 → 2.0.5

package/README.md

@@ -50,6 +50,7 @@ Cards — Read
 - `get_user_story_content` — Fetch full content of a user story by ID (id)
 - `get_bug_comments` — Get comments on a bug (id, optional results)
 - `get_user_story_comments` — Get comments on a user story (id, optional results)
+- `get_user_story_test_cases` — Fetch the linked test plan and all its test cases (with steps) for a user story (resourceId)
 - `search_all_cards_by_keyword` — Search bugs, stories, and features by keyword (keyword)
 
 Cards — Write

package/build/index.js

@@ -597,8 +597,8 @@ 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;
-        4) add a comment to the card with bug Id provided in the first step and Title`,
+        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>);
+        4) add a comment to the card with created bug Id and its Title`,
     inputSchema: {
         title: z.string()
             .describe('Bug card title that summarizes the problem in concise, descriptive, and actionable manner, enabling a developer to understand the issue without opening the report'),
@@ -650,10 +650,9 @@ server.registerTool('create_bug_based_on_card', {
 server.registerTool('create_bug', {
     title: 'Create a new bug card',
     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 referenced.
+      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;
-        2) add a comment to the newly created bug with its Id and Title`,
+        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>);`,
     inputSchema: {
         title: z.string()
             .describe('Bug card title that summarizes the problem in concise, descriptive, and actionable manner, enabling a developer to understand the issue without opening the report'),
@@ -946,6 +945,81 @@ server.registerTool('get_logged_in_user', {
             }],
     };
 });
+server.registerTool('get_user_story_test_cases', {
+    title: 'Get test cases for TP UserStory card',
+    description: `Fetches a TP UserStory Linked Test Plan and fetches its Test Cases by provided card ID.`,
+    inputSchema: {
+        resourceId: z.string()
+            .min(5)
+            .max(6)
+            .describe('TP UserStory ID (e.g. 145789)')
+    },
+}, async ({ resourceId }) => {
+    const userStoryResponse = await tp.getUserStoryTestPlan(resourceId);
+    if (!userStoryResponse) {
+        return {
+            content: [{
+                    type: 'text',
+                    text: `Failed to get test user story, JSON: ${JSON.stringify(userStoryResponse, null, 2)}`
+                }],
+        };
+    }
+    const items = userStoryResponse.items;
+    if (items.length === 0) {
+        return {
+            content: [{
+                    type: 'text',
+                    text: `No items in ${resourceId} user story response`,
+                }],
+        };
+    }
+    const testPlan = items[0].linkedTestPlan;
+    if (!testPlan) {
+        return {
+            content: [{
+                    type: 'text',
+                    text: `No linked test plan found for user story id: ${resourceId}`,
+                }],
+        };
+    }
+    const testCases = await tp.getTestPlanTestCases(String(testPlan.id));
+    if (testCases.Items.length === 0) {
+        return {
+            content: [{
+                    type: 'text',
+                    text: `No test cases found in test plan id: ${testPlan.id}`,
+                }],
+        };
+    }
+    const testCaseItems = testCases.Items;
+    if (!testCaseItems || testCaseItems.length === 0) {
+        return {
+            content: [{
+                    type: 'text',
+                    text: `No test case items found in test plan id: ${testPlan.id}`,
+                }],
+        };
+    }
+    const testCasesData = await Promise.all(testCaseItems.map(async (item) => {
+        const testCaseSteps = await tp.getTestCaseSteps(String(item.Id));
+        return {
+            testCaseId: item.Id,
+            testCaseName: item.Name,
+            testCaseDescription: item.Description,
+            testCaseSteps: testCaseSteps.Items.map((step) => ({
+                description: step.Description,
+                result: step.Result,
+                runOrder: step.RunOrder,
+            }))
+        };
+    }));
+    return {
+        content: [{
+                type: 'text',
+                text: JSON.stringify(testCasesData)
+            }],
+    };
+});
 server.registerTool('write_test_cases', {
     title: 'Write test cases for a TP card (UserStory, Bug, or Feature)',
     description: `Fetches a TP card (UserStory, Bug, or Feature) content by ID.

package/build/tp.js

@@ -381,6 +381,53 @@ export class TpClient {
             apiVersion: this.v2
         });
     }
+    async getUserStoryTestPlan(userStoryId) {
+        return this.get({
+            pathParam: { "userStories": userStoryId },
+            param: {
+                "format": "json",
+                "select": `{id,storyName:name,linkedtestplan}`,
+            },
+            apiVersion: this.v2
+        });
+    }
+    async getCardTestPlan(cardId, resourceType = 'UserStory') {
+        let requestPath = "";
+        if (resourceType === 'UserStory') {
+            requestPath = "userStories";
+        }
+        else if (resourceType === 'Bug') {
+            requestPath = "bugs";
+        }
+        else if (resourceType === 'Feature') {
+            requestPath = "features";
+        }
+        return this.get({
+            pathParam: { [requestPath]: cardId },
+            param: {
+                "format": "json",
+                "select": `{id,linkedtestplan}`,
+            },
+        });
+    }
+    async getTestPlanTestCases(testPlanId) {
+        return this.get({
+            pathParam: {
+                "testPlans": testPlanId,
+                "testcases": "",
+            },
+            param: { "format": "json" },
+        });
+    }
+    async getTestCaseSteps(testCaseId) {
+        return this.get({
+            pathParam: {
+                "testCases": testCaseId,
+                "teststeps": "",
+            },
+            param: { "format": "json", },
+        });
+    }
     async getProjects() {
         return this.get({
             pathParam: { "Projects": '' },

package/package.json

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