targetprocess-mcp-server 1.0.14 → 1.0.16

package/README.md

@@ -12,8 +12,8 @@ It acts as a **bridge between LLM agents and the Targetprocess API**, providing:
 ---
 
 ## Features
-  - Create Bugs based on user story
-  - Retreive TP entities: bugs, user stories
+  - Create standalone bugs or bugs linked to a user story/bug card
+  - Retrieve TP entities: bugs, user stories, features, releases
 
 - **LLM-Friendly Tools**
   - Designed for Claude MCP AI agents
@@ -50,8 +50,11 @@ Cards — Read
 
 Cards — Write
 - `add_comment` — Post a comment to any card (id, comment)
-- `create_bug` — Create a new bug linked to a card (card object with id+type, title, bugContent)
+- `create_bug` — Create a standalone bug (title, bugContent, optional origin)
+- `create_bug_based_on_card` — Create a bug linked to an existing user story or bug card (card object with id+type, title, bugContent, optional origin)
 - `create_test_plan` — Create a test plan linked to a user story (title, userStoryId)
+
+> `origin` accepted values: `Production - Customer`, `Production - Internal`, `Pre-Release - Customer`, `Pre-Release - Internal`, `Regression - Dev01`, `Regression - Team Env`, `Manual QA` *(default)*, `Developer Raised`, `Operations`
 ---
 
 ## Installation

package/build/index.js

@@ -589,7 +589,7 @@ server.registerTool('get_bug_comments', {
             }],
     };
 });
-server.registerTool('create_bug', {
+server.registerTool('create_bug_based_on_card', {
     title: 'Create a new bug card based on provided card id',
     description: `Create a new bug card based on provided card id that summarizes the problem in concise,
       descriptive manner answering questions What? Where? When?,
@@ -615,9 +615,72 @@ server.registerTool('create_bug', {
                   Be specific and avoid assumptions.
                   Clearly outline the actions needed to trigger the bug.
                   Number each step so anyone can follow them easily`),
+        origin: z.enum([
+            "Production - Customer",
+            "Production - Internal",
+            "Pre-Release - Customer",
+            "Pre-Release - Internal",
+            "Regression - Dev01",
+            "Regression - Team Env",
+            "Manual QA",
+            "Developer Raised",
+            "Operations",
+        ])
+            .default("Manual QA")
+            .optional()
+            .describe('Where the bug was found, defaults to "Manual QA"'),
+    },
+}, async ({ title, card, bugContent, origin }) => {
+    const bugResponse = await tp.createBug({ title, card, bugContent, origin });
+    if (!bugResponse) {
+        return {
+            content: [{
+                    type: 'text',
+                    text: `Failed to create bug "${title}"\n JSON: ${JSON.stringify(bugResponse, null, 2)}`
+                }]
+        };
+    }
+    return {
+        content: [{
+                type: 'text',
+                text: JSON.stringify(bugResponse)
+            }],
+    };
+});
+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.
+      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`,
+    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'),
+        bugContent: z.string()
+            .describe(`Bug description content, explain what happened in detail.
+                  Include expected behaviour and what actually occurred.
+                  Be specific and avoid assumptions.
+                  Clearly outline the actions needed to trigger the bug.
+                  Number each step so anyone can follow them easily`),
+        origin: z.enum([
+            "Production - Customer",
+            "Production - Internal",
+            "Pre-Release - Customer",
+            "Pre-Release - Internal",
+            "Regression - Dev01",
+            "Regression - Team Env",
+            "Manual QA",
+            "Developer Raised",
+            "Operations",
+        ])
+            .default("Manual QA")
+            .optional()
+            .describe('Where the bug was found, defaults to "Manual QA"'),
     },
-}, async ({ title, card, bugContent }) => {
-    const bugResponse = await tp.createBug({ title, card, bugContent });
+}, async ({ title, bugContent, origin }) => {
+    const bugResponse = await tp.createBugOnly({ title, bugContent, origin });
     if (!bugResponse) {
         return {
             content: [{
@@ -661,6 +724,79 @@ server.registerTool('create_test_plan', {
             }],
     };
 });
+server.registerTool('get_not_covered_user_stories_in_feature', {
+    title: 'Get not covered user stories in feature',
+    description: 'Get user stories for a TP feature by its ID that are not covered by any tests',
+    inputSchema: {
+        id: z.string()
+            .min(5)
+            .max(6)
+            .describe('TP feature ID (e.g. 145636)'),
+    },
+}, async ({ id }) => {
+    const response = await tp.getUserStoriesByFeatureId(id);
+    if (!response) {
+        return {
+            content: [{
+                    type: 'text',
+                    text: `Failed to get user stories for feature id: ${id}`
+                }],
+        };
+    }
+    const userStoriesIds = response.items || [];
+    if (userStoriesIds.length === 0) {
+        return {
+            content: [{
+                    type: 'text',
+                    text: `No user stories found in outer items for feature id: ${id}`,
+                }],
+        };
+    }
+    const userStoriesPromise = userStoriesIds.map((id) => tp.getUserStory(id));
+    let userStoriesResults = [];
+    try {
+        userStoriesResults = await Promise.all(userStoriesPromise);
+    }
+    catch (error) {
+        console.error("Error getting user stories:", error);
+        return {
+            content: [{
+                    type: 'text',
+                    text: `Failed to get user stories for feature id: ${id}`,
+                }],
+        };
+    }
+    let userStories = [];
+    for (const userStory of userStoriesResults) {
+        const userStoryId = userStory.Id;
+        const feature = userStory.Feature;
+        const featureId = feature.Id;
+        const featureName = feature.Name;
+        const covered = userStory.CustomFields.find((field) => field.Name === "Test Automation")?.Value === "Done";
+        userStories.push({
+            id: userStoryId,
+            name: userStory.Name,
+            description: userStory.Description,
+            featureId,
+            featureName,
+            covered,
+        });
+    }
+    if (userStories.length === 0) {
+        return {
+            content: [{
+                    type: 'text',
+                    text: `No user stories unable to convert to TP card found for feature id: ${id}`,
+                }],
+        };
+    }
+    return {
+        content: [{
+                type: 'text',
+                text: JSON.stringify(userStories)
+            }],
+    };
+});
 server.registerTool('get_feature_user_stories', {
     title: 'Get feature user stories',
     description: 'Get user stories for a TP feature by its ID',

package/build/tp.js

@@ -96,7 +96,7 @@ export class TpClient {
         });
         return response;
     }
-    async createBug({ title, card, bugContent }) {
+    async createBug({ title, card, bugContent, origin = "Manual QA" }) {
         const bug = {
             "Name": title,
             "Project": {
@@ -105,7 +105,7 @@ export class TpClient {
             "customFields": [{
                     "name": "Origin",
                     "type": "DropDown",
-                    "value": "Manual QA"
+                    "value": origin
                 }],
             "assignedTeams": [{
                     "team": {
@@ -124,6 +124,29 @@ export class TpClient {
             param: { "format": "json" },
         }, bug);
     }
+    async createBugOnly({ title, bugContent, origin = "Manual QA" }) {
+        const bug = {
+            "Name": title,
+            "Project": {
+                "Id": config.tp.projectId
+            },
+            "customFields": [{
+                    "name": "Origin",
+                    "type": "DropDown",
+                    "value": origin
+                }],
+            "assignedTeams": [{
+                    "team": {
+                        "id": config.tp.teamId
+                    }
+                }],
+            "Description": bugContent,
+        };
+        return this.post({
+            pathParam: { "bugs": '' },
+            param: { "format": "json" },
+        }, bug);
+    }
     async createBugBasedOnUserStory(title, userStoryId, bugContent) {
         const bug = {
             "Name": title,
@@ -309,6 +332,17 @@ export class TpClient {
             apiVersion: this.v2
         });
     }
+    async getUserStoriesByFeatureId(featureId) {
+        return this.get({
+            pathParam: { "userstories": '' },
+            param: {
+                "format": "json",
+                "where": `(Feature.Id==${featureId})`,
+                "select": `{id}`,
+            },
+            apiVersion: this.v2
+        });
+    }
     async getContext() {
         return this.get({
             pathParam: { "Context": '' },

package/package.json

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