targetprocess-mcp-server 2.1.8 → 2.2.1

package/README.md

@@ -55,13 +55,16 @@ Cards — Read
 
 Cards — Write
 - `add_comment` — Post a comment to any card (id, comment)
-- `create_bug` — Create a standalone bug (title, bugContent, optional origin)
+- `create_bug` — Create a standalone bug (title, bugContent, optional origin, optional projectId, optional teamId)
   > `origin` accepted values: `Production - Customer`, `Production - Internal`, `Pre-Release - Customer`, `Pre-Release - Internal`, `Regression - Dev01`, `Regression - Team Env`, `Manual QA` *(default)*, `Developer Raised`, `Operations`
 > [!NOTE]  
-> requires `TP_PROJECT_ID`, `TP_TEAM_ID`  
-- `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)  
+> `projectId` and `teamId` are optional — fall back to `TP_PROJECT_ID` and `TP_TEAM_ID` from config  
+- `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, optional projectId, optional teamId)  
 > [!NOTE]  
-> requires `TP_PROJECT_ID`, `TP_TEAM_ID`  
+> `projectId` and `teamId` are optional — fall back to `TP_PROJECT_ID` and `TP_TEAM_ID` from config  
+- `create_user_story` — Create a new user story (title, optional description, optional featureId, optional releaseId, optional projectId, optional teamId)  
+> [!NOTE]  
+> `projectId` and `teamId` are optional — fall back to `TP_PROJECT_ID` and `TP_TEAM_ID` from config  
 - `create_test_plan` — Create a test plan linked to a UserStory, Bug, or Feature (title, resourceId, optional resourceType, optional description/startDate/endDate)  
 > [!NOTE]  
 > requires `TP_PROJECT_ID`, 

package/build/index.js

@@ -1,4 +1,6 @@
 #!/usr/bin/env node
+import { execSync } from "child_process";
+import { homedir } from "os";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { z } from "zod";
 import { JSDOM } from "jsdom";
@@ -335,17 +337,21 @@ server.registerTool('get_release_open_user_stories', {
 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`,
+    NOTE: after results are returned, try analyze and filter results by most relevant to what user is looking for in the description text
+    FALLBACK: if no results are found, try spliting phrase by spaces and searching for each word and with "Generals" entity type`,
     inputSchema: {
         keyword: z.string()
             .describe('Keyword or partial name or keyphrase to search for in description'),
-        entityType: z.enum(["UserStories", "Bugs"])
+        entityType: z.enum(["UserStories", "Bugs", "Generals"])
             .default("UserStories")
             .optional()
             .describe('Type of TP entity to search — UserStories or Bugs (default: UserStories)'),
     },
 }, async ({ keyword, entityType = "UserStories" }) => {
-    const results = await tp.searchContainsDescriptionText({ text: keyword, entityType });
+    const results = await Promise.all([
+        tp.searchContainsNameText({ text: keyword, entityType }),
+        tp.searchContainsDescriptionText({ text: keyword, entityType })
+    ]);
     if (!results) {
         return {
             content: [{
@@ -354,7 +360,7 @@ server.registerTool('search_tp_cards', {
                 }],
         };
     }
-    const items = results.Items || [];
+    const items = results.map((item) => item.Items).flat();
     if (items.length == 0) {
         return {
             content: [{
@@ -629,9 +635,15 @@ server.registerTool('create_bug_based_on_card', {
             .default("Manual QA")
             .optional()
             .describe('Where the bug was found, defaults to "Manual QA"'),
+        projectId: z.string()
+            .optional()
+            .describe('Optional Project ID — defaults to TP_PROJECT_ID from config'),
+        teamId: z.string()
+            .optional()
+            .describe('Optional Team ID — defaults to TP_TEAM_ID from config'),
     },
-}, async ({ title, card, bugContent, origin }) => {
-    const bugResponse = await tp.createBug({ title, card, bugContent, origin });
+}, async ({ title, card, bugContent, origin, projectId, teamId }) => {
+    const bugResponse = await tp.createBug({ title, card, bugContent, origin, projectId, teamId });
     if (!bugResponse) {
         return {
             content: [{
@@ -672,9 +684,15 @@ server.registerTool('create_bug', {
             .default("Manual QA")
             .optional()
             .describe('Where the bug was found, defaults to "Manual QA"'),
+        projectId: z.string()
+            .optional()
+            .describe('Optional Project ID — defaults to TP_PROJECT_ID from config'),
+        teamId: z.string()
+            .optional()
+            .describe('Optional Team ID — defaults to TP_TEAM_ID from config'),
     },
-}, async ({ title, bugContent, origin }) => {
-    const bugResponse = await tp.createBugOnly({ title, bugContent, origin });
+}, async ({ title, bugContent, origin, projectId, teamId }) => {
+    const bugResponse = await tp.createBugOnly({ title, bugContent, origin, projectId, teamId });
     if (!bugResponse) {
         return {
             content: [{
@@ -690,6 +708,49 @@ server.registerTool('create_bug', {
             }],
     };
 });
+server.registerTool('create_user_story', {
+    title: 'Create a new user story',
+    description: `Create a new user story in Targetprocess.`,
+    inputSchema: {
+        title: z.string()
+            .describe('User story title'),
+        description: z.string()
+            .optional()
+            .describe('Optional user story description (when provided, format as HTML)'),
+        featureId: z.string()
+            .min(5)
+            .max(6)
+            .optional()
+            .describe('Optional Feature ID to link this user story to (e.g. 145636)'),
+        releaseId: z.string()
+            .min(5)
+            .max(6)
+            .optional()
+            .describe('Optional Release ID to link this user story to (e.g. 145200)'),
+        projectId: z.string()
+            .optional()
+            .describe('Optional Project ID — defaults to TP_PROJECT_ID from config'),
+        teamId: z.string()
+            .optional()
+            .describe('Optional Team ID — defaults to TP_TEAM_ID from config'),
+    },
+}, async ({ title, description, featureId, releaseId, projectId, teamId }) => {
+    const userStoryResponse = await tp.createUserStory({ title, description, featureId, releaseId, projectId, teamId });
+    if (!userStoryResponse) {
+        return {
+            content: [{
+                    type: 'text',
+                    text: `Failed to create user story "${title}"\n JSON: ${JSON.stringify(userStoryResponse, null, 2)}`
+                }]
+        };
+    }
+    return {
+        content: [{
+                type: 'text',
+                text: JSON.stringify(userStoryResponse)
+            }],
+    };
+});
 server.registerTool('create_test_plan', {
     title: 'Create a new test plan linked to a TP card',
     description: `Create a new test plan linked to a UserStory, Bug, or Feature. Name and Project are required by the API; Description, StartDate, and EndDate are optional.`,
@@ -1136,6 +1197,92 @@ server.registerTool('add_test_cases_to_test_plan', {
             }]
     };
 });
+server.registerTool('add_attached_file_to_card', {
+    title: 'Attach a file to a TP card',
+    description: 'Upload and attach a local file to a Targetprocess entity (UserStory, Bug, Feature, etc.) by its ID',
+    inputSchema: {
+        generalId: z.string()
+            .min(5)
+            .max(6)
+            .describe('TP entity ID to attach the file to (e.g. 145789)'),
+        filePath: z.string()
+            .describe('Absolute path to the local file to upload (e.g. /Users/mcs/Desktop/image.png)'),
+    },
+}, async ({ generalId, filePath }) => {
+    try {
+        const result = await tp.addAttachedFile(generalId, filePath);
+        if (!result) {
+            return {
+                content: [{
+                        type: 'text',
+                        text: `Failed to attach file "${filePath}" to card id: ${generalId}`
+                    }]
+            };
+        }
+        return {
+            content: [{
+                    type: 'text',
+                    text: result
+                }]
+        };
+    }
+    catch (error) {
+        return {
+            content: [{
+                    type: 'text',
+                    text: `Error attaching file to card ${generalId}: ${error}`
+                }]
+        };
+    }
+});
+server.registerTool('find_file_on_disk', {
+    title: 'Find a file on disk by name',
+    description: `Search for a file by name on the local filesystem.
+      First tries an exact (case-insensitive) match.
+      If nothing is found, retries using the first half of the filename (without extension) as a wildcard — e.g. "screenshot_bug" becomes "*screensho*".
+      Returns a list of matching absolute paths.`,
+    inputSchema: {
+        fileName: z.string()
+            .describe('Filename to search for, with or without extension (e.g. "screenshot.png" or "report")'),
+        searchDir: z.string()
+            .optional()
+            .describe('Directory to search in — defaults to the user home directory'),
+    },
+}, async ({ fileName, searchDir }) => {
+    const dir = searchDir || homedir();
+    const runFind = (pattern) => {
+        try {
+            const out = execSync(`find "${dir}" -iname "${pattern}" 2>/dev/null`, {
+                encoding: 'utf8',
+                timeout: 15000,
+            });
+            return out.trim().split('\n').filter(Boolean);
+        }
+        catch {
+            return [];
+        }
+    };
+    // Exact match
+    let files = runFind(fileName);
+    if (files.length > 0) {
+        return {
+            content: [{ type: 'text', text: JSON.stringify({ match: 'exact', files }) }]
+        };
+    }
+    // Partial match: first half of name without extension
+    const dotIndex = fileName.lastIndexOf('.');
+    const nameOnly = dotIndex > 0 ? fileName.slice(0, dotIndex) : fileName;
+    const half = nameOnly.slice(0, Math.ceil(nameOnly.length / 2));
+    files = runFind(`*${half}*`);
+    if (files.length > 0) {
+        return {
+            content: [{ type: 'text', text: JSON.stringify({ match: 'partial', keyword: half, files }) }]
+        };
+    }
+    return {
+        content: [{ type: 'text', text: `No files found matching "${fileName}" or partial keyword "${half}" in ${dir}` }]
+    };
+});
 async function main() {
     const transport = new StdioServerTransport();
     await server.connect(transport);

package/build/tp.js

@@ -1,3 +1,5 @@
+import { readFileSync } from "fs";
+import { basename } from "path";
 import { config } from "./config.js";
 export class TpClient {
     baseUrl = config.tp.url;
@@ -100,11 +102,11 @@ export class TpClient {
         });
         return response;
     }
-    async createBug({ title, card, bugContent, origin = "Manual QA" }) {
+    async createBug({ title, card, bugContent, origin = "Manual QA", projectId, teamId }) {
         const bug = {
             "Name": title,
             "Project": {
-                "Id": config.tp.projectId
+                "Id": projectId || config.tp.projectId
             },
             "customFields": [{
                     "name": "Origin",
@@ -113,7 +115,7 @@ export class TpClient {
                 }],
             "assignedTeams": [{
                     "team": {
-                        "id": config.tp.teamId
+                        "id": teamId || config.tp.teamId
                     }
                 }],
             "Description": bugContent,
@@ -128,11 +130,11 @@ export class TpClient {
             param: { "format": "json" },
         }, bug);
     }
-    async createBugOnly({ title, bugContent, origin = "Manual QA" }) {
+    async createBugOnly({ title, bugContent, origin = "Manual QA", projectId, teamId }) {
         const bug = {
             "Name": title,
             "Project": {
-                "Id": config.tp.projectId
+                "Id": projectId || config.tp.projectId
             },
             "customFields": [{
                     "name": "Origin",
@@ -141,7 +143,7 @@ export class TpClient {
                 }],
             "assignedTeams": [{
                     "team": {
-                        "id": config.tp.teamId
+                        "id": teamId || config.tp.teamId
                     }
                 }],
             "Description": bugContent,
@@ -151,6 +153,23 @@ export class TpClient {
             param: { "format": "json" },
         }, bug);
     }
+    async createUserStory({ title, description, featureId, releaseId, projectId, teamId }) {
+        const userStory = {
+            "Name": title,
+            "Project": { "Id": projectId || config.tp.projectId },
+            "assignedTeams": [{ "team": { "id": teamId || config.tp.teamId } }],
+        };
+        if (description)
+            userStory["Description"] = description;
+        if (featureId)
+            userStory["Feature"] = { "Id": featureId };
+        if (releaseId)
+            userStory["Release"] = { "Id": releaseId };
+        return this.post({
+            pathParam: { "UserStories": '' },
+            param: { "format": "json" },
+        }, userStory);
+    }
     async createBugBasedOnUserStory(title, userStoryId, bugContent) {
         const bug = {
             "Name": title,
@@ -457,4 +476,26 @@ export class TpClient {
             param: { "format": "json", }
         });
     }
+    async addAttachedFile(generalId, filePath) {
+        const fileContent = readFileSync(filePath);
+        const fileName = basename(filePath);
+        const formData = new FormData();
+        formData.append("generalId", generalId);
+        formData.append("file", new Blob([fileContent]), fileName);
+        const url = `${this.baseUrl}/UploadFile.ashx?access_token=${this.token}`;
+        try {
+            const response = await fetch(url, {
+                method: "POST",
+                body: formData,
+            });
+            if (!response.ok) {
+                throw new Error(`HTTP error! status: ${response.status}`);
+            }
+            return response.text();
+        }
+        catch (error) {
+            console.error("Error uploading file:", error);
+            return null;
+        }
+    }
 }

package/package.json

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