targetprocess-mcp-server 2.0.6 → 2.1.7-a

package/README.md

@@ -51,14 +51,13 @@ Cards — Read
 - `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)
+- `search_tp_cards` — Search TP cards by keyword or phrase in description (keyword, optional entityType: UserStories | Bugs, default: UserStories)
 
 Cards — Write
 - `add_comment` — Post a comment to any card (id, comment)
 - `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 UserStory, Bug, or Feature (title, resourceId, optional resourceType, optional description/startDate/endDate)
-- `add_test_cases` — Create a test plan and add generated test cases to it in one call (resourceId, testPlanTitle, testCases array of {name, description}, optional resourceType)
 
 Test Case Workflows
 - `write_test_cases` — Fetch a card (UserStory, Bug, or Feature) by ID and trigger the full test case writing workflow: Claude analyzes the card, generates detailed test cases covering happy path, edge cases, and error scenarios, creates a linked test plan via `create_test_plan`, then calls `add_test_cases_to_test_plan`. Each test case description contains Preconditions and Test Type as HTML; steps are passed as a structured array (resourceId, optional resourceType)

package/build/index.js

@@ -332,34 +332,34 @@ server.registerTool('get_release_open_user_stories', {
             }],
     };
 });
-server.registerTool('search_all_cards_by_keyword', {
-    title: 'Search TP cards (user stories, bugs, features) by keyword or partial name',
-    description: `Searches tp cards (user stories, bugs, features) by keyword or partial name or partial keyphrase e.g. "Text Element"`,
+server.registerTool('search_tp_cards', {
+    title: 'Search TP cards by keyword or phrase in description',
+    description: `Searches TP cards (UserStories or Bugs) by keyword or phrase or partial keyphrase in Card Description e.g. "Text Element", "Font field"
+    NOTE: after results are returned, try analyze and filter results by most relevant to what user is looking for in the description text`,
     inputSchema: {
         keyword: z.string()
-            .describe('Keyword or partial name or keyphrase to search for'),
+            .describe('Keyword or partial name or keyphrase to search for in description'),
+        entityType: z.enum(["UserStories", "Bugs"])
+            .default("UserStories")
+            .optional()
+            .describe('Type of TP entity to search — UserStories or Bugs (default: UserStories)'),
     },
-}, async ({ keyword }) => {
-    const results = await Promise.all([
-        tp.searchContainsNameText({ text: keyword, entityType: "UserStories" }),
-        tp.searchContainsNameText({ text: keyword, entityType: "Bugs" }),
-        tp.searchContainsNameText({ text: keyword, entityType: "Features" }),
-    ]);
-    const generalResults = results.map((item) => item.Items).flat();
-    if (!generalResults) {
+}, async ({ keyword, entityType = "UserStories" }) => {
+    const results = await tp.searchContainsDescriptionText({ text: keyword, entityType });
+    if (!results) {
         return {
             content: [{
                     type: 'text',
-                    text: `Failed to find card by keyword: "${keyword}"\n JSON: ${JSON.stringify(generalResults, null, 2)}`
+                    text: `Failed to search for keyword: "${keyword}"\n JSON: ${JSON.stringify(results, null, 2)}`
                 }],
         };
     }
-    const items = generalResults || [];
+    const items = results.Items || [];
     if (items.length == 0) {
         return {
             content: [{
-                    type: "text",
-                    text: `No results for ${keyword}`,
+                    type: 'text',
+                    text: `Failed to find card by keyword: "${keyword}"\n JSON: ${JSON.stringify(results, null, 2)}`
                 }],
         };
     }
@@ -1030,7 +1030,7 @@ server.registerTool('write_test_cases', {
             - name: concise action-oriented title
             - description: HTML <div> with Preconditions and Test Type sections only (no steps here)
             - steps: ordered array of { description: "<step action>", result: "<expected result>" }
-        4) Call "create_test_plan" tool passing: resourceId (the card id), resourceType, testPlanTitle (use the card name/title)
+        4) Call "create_test_plan" tool passing: resourceId (the card id), resourceType, testPlanTitle (use the card name/title), NOTE: IF test plan already exists - skip this step and proceed to step 5.
         5) Call "add_test_cases_to_test_plan" tool passing: testPlanId (the test plan id), and the testCases array with name, description, and steps`,
     inputSchema: {
         resourceId: z.string()

package/build/tp.js

@@ -43,6 +43,7 @@ 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",
@@ -290,6 +291,16 @@ export class TpClient {
             },
         });
     }
+    async searchContainsDescriptionText({ text, entityType }) {
+        return this.get({
+            pathParam: { [entityType]: '' },
+            param: {
+                "where": `Description contains '${text}' and EntityState.Name eq 'Done'`,
+                "format": "json",
+                "take": "50",
+            },
+        });
+    }
     async getCurrentReleases() {
         return this.get({
             pathParam: { "Releases": '' },

package/package.json

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