targetprocess-mcp-server 2.2.8 → 2.2.10

package/README.md

@@ -48,6 +48,10 @@ Features
 User Stories
 - `get_user_story_bugs` — Get all bugs linked to a user story by its ID (id)
 
+Tasks
+- `get_in_progress_tasks_and_bugs` — Get all Tasks and Bugs currently in "In Progress" state assigned to a given user (userId)
+- `create_task` — Create a new task linked to a user story (title, userStoryId, optional description)
+
 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)
@@ -100,6 +104,12 @@ Teams
 User
 - `get_logged_in_user` — Get the currently logged-in user's info (no params needed)
 
+Developer Tools
+- `get_commit_message` — Returns a formatted commit message string for a task or bug ID (id, type: task | bug)
+  > Format for task on a user story: `F#<featureId> US#<userStoryId> T#<taskId> <title>`
+  > Format for bug on a user story: `F#<featureId> US#<userStoryId> B#<bugId> <title>`
+  > Format for standalone bug: `B#<bugId> <title>`
+
 
 ---
 

package/build/index.js

@@ -599,10 +599,10 @@ server.registerTool('get_bug_comments', {
 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?, and content explaining what happened in detail. 
-      NOTE: this tool requires a user story or bug card as a reference (i.e. card ID).
+      NOTE: this tool requires a user story, bug, or feature card as a reference (i.e. card ID).
       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;
+        1) IF you already have user story, bug, or feature card content, proceed to step 3 skipping step 2;
+        2) ELSE call "get_user_story_content" tool, "get_bug_content" tool, or fetch the feature to get card content;
         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;
@@ -614,8 +614,8 @@ server.registerTool('create_bug_based_on_card', {
             id: z.string()
                 .min(5)
                 .max(6)
-                .describe(`Usually user story id or bug ID (e.g. 145789)`),
-            type: z.enum(["UserStory", "Bug"])
+                .describe(`Usually user story id, bug ID, or feature ID (e.g. 145789)`),
+            type: z.enum(["UserStory", "Bug", "Feature"])
         }),
         bugContent: z.string()
             .describe(`Comment content to add, explain what happened in detail.
@@ -1557,6 +1557,138 @@ server.registerTool('get_card_current_status', {
             }],
     };
 });
+server.registerTool('get_in_progress_tasks_and_bugs', {
+    title: 'Get in-progress tasks and bugs for a user',
+    description: 'Get all Tasks and Bugs currently in "In Progress" state assigned to a given user ID',
+    inputSchema: {
+        userId: z.string()
+            .describe('Targetprocess user ID (e.g. 123)'),
+    },
+}, async ({ userId }) => {
+    const result = await tp.getInProgressTasksAndBugs(userId);
+    const tasks = result.tasks.map((t) => ({
+        type: 'Task',
+        id: t.Id,
+        name: t.Name,
+        state: t.EntityState?.Name,
+        userStoryId: t.UserStory?.Id,
+        userStoryName: t.UserStory?.Name,
+        featureId: t.UserStory?.Feature?.Id,
+        featureName: t.UserStory?.Feature?.Name,
+    }));
+    const bugs = result.bugs.map((b) => ({
+        type: 'Bug',
+        id: b.Id,
+        name: b.Name,
+        state: b.EntityState?.Name,
+        userStoryId: b.UserStory?.Id,
+        userStoryName: b.UserStory?.Name,
+        featureId: b.UserStory?.Feature?.Id ?? b.Feature?.Id,
+        featureName: b.UserStory?.Feature?.Name ?? b.Feature?.Name,
+    }));
+    const items = [...tasks, ...bugs];
+    if (items.length === 0) {
+        return {
+            content: [{
+                    type: 'text',
+                    text: `No in-progress tasks or bugs found for user ID: ${userId}`,
+                }],
+        };
+    }
+    return {
+        content: [{
+                type: 'text',
+                text: JSON.stringify(items),
+            }],
+    };
+});
+server.registerTool('create_task', {
+    title: 'Create a new task',
+    description: 'Create a new task linked to a user story.',
+    inputSchema: {
+        title: z.string()
+            .describe('Task title'),
+        userStoryId: z.string()
+            .min(5)
+            .max(6)
+            .describe('User story ID to link the task to (e.g. 145789)'),
+        description: z.string()
+            .optional()
+            .describe('Task description (optional)'),
+    },
+}, async ({ title, userStoryId, description }) => {
+    const taskResponse = await tp.createTask({ title, userStoryId, description });
+    if (!taskResponse) {
+        return {
+            content: [{
+                    type: 'text',
+                    text: `Failed to create task "${title}"\n JSON: ${JSON.stringify(taskResponse, null, 2)}`
+                }]
+        };
+    }
+    return {
+        content: [{
+                type: 'text',
+                text: JSON.stringify(taskResponse)
+            }],
+    };
+});
+server.registerTool('get_commit_message', {
+    title: 'Get commit message for a task or bug',
+    description: `Returns the formatted commit message string for a given task or bug ID.
+Formats:
+- Task on a user story: "F#<featureId> US#<userStoryId> T#<taskId> <title>"
+- Bug on a user story: "F#<featureId> US#<userStoryId> B#<bugId> <title>"
+- Standalone bug (no user story): "B#<bugId> <title>"`,
+    inputSchema: {
+        id: z.string()
+            .describe('The task or bug ID (e.g. 145789)'),
+        type: z.enum(['task', 'bug'])
+            .describe('Whether the ID refers to a task or a bug'),
+    },
+}, async ({ id, type }) => {
+    if (type === 'task') {
+        const task = await tp.getTask(id);
+        if (!task) {
+            return {
+                content: [{ type: 'text', text: `Failed to get task with id: ${id}` }],
+            };
+        }
+        const userStory = task.UserStory;
+        const feature = userStory?.Feature;
+        if (!userStory) {
+            return {
+                content: [{ type: 'text', text: `Task ${id} has no linked user story` }],
+            };
+        }
+        const prefix = feature
+            ? `F#${feature.Id} US#${userStory.Id} T#${task.Id}`
+            : `US#${userStory.Id} T#${task.Id}`;
+        return {
+            content: [{ type: 'text', text: `${prefix} ${task.Name}` }],
+        };
+    }
+    // type === 'bug'
+    const bug = await tp.getBugWithRelations(id);
+    if (!bug) {
+        return {
+            content: [{ type: 'text', text: `Failed to get bug with id: ${id}` }],
+        };
+    }
+    const userStory = bug.UserStory;
+    const feature = userStory?.Feature ?? bug.Feature;
+    if (!userStory) {
+        return {
+            content: [{ type: 'text', text: `B#${bug.Id} ${bug.Name}` }],
+        };
+    }
+    const prefix = feature
+        ? `F#${feature.Id} US#${userStory.Id} B#${bug.Id}`
+        : `US#${userStory.Id} B#${bug.Id}`;
+    return {
+        content: [{ type: 'text', text: `${prefix} ${bug.Name}` }],
+    };
+});
 async function main() {
     const transport = new StdioServerTransport();
     await server.connect(transport);

package/build/tp.js

@@ -120,9 +120,10 @@ export class TpClient {
             "Description": bugContent,
         };
         if (card.type === "UserStory") {
-            bug["UserStory"] = {
-                "Id": card.id
-            };
+            bug["UserStory"] = { "Id": card.id };
+        }
+        else if (card.type === "Feature") {
+            bug["Feature"] = { "Id": card.id };
         }
         return this.post({
             pathParam: ["bugs"],
@@ -591,6 +592,57 @@ export class TpClient {
             param: { "format": "json" }
         });
     }
+    async getInProgressTasksAndBugs(userId) {
+        const where = `(EntityState.Name eq 'In Progress') and (AssignedUser.Id eq ${userId})`;
+        const include = "[Id,Name,EntityState[Name],UserStory[Id,Name,Feature[Id,Name]]]";
+        const param = { "format": "json", "where": where, "include": include, "orderByDesc": "ModifyDate" };
+        const [tasks, bugs] = await Promise.all([
+            this.get({ pathParam: ["Tasks"], param }),
+            this.get({ pathParam: ["Bugs"], param }),
+        ]);
+        return {
+            tasks: tasks?.Items ?? [],
+            bugs: bugs?.Items ?? [],
+        };
+    }
+    async getTask(taskId) {
+        const response = await this.get({
+            pathParam: ["Tasks", taskId],
+            param: {
+                "format": "json",
+                "include": "[Id,Name,UserStory[Id,Name,Feature[Id,Name]]]",
+            }
+        });
+        return response;
+    }
+    async getBugWithRelations(bugId) {
+        const response = await this.get({
+            pathParam: ["Bugs", bugId],
+            param: {
+                "format": "json",
+                "include": "[Id,Name,UserStory[Id,Name,Feature[Id,Name]]]",
+            }
+        });
+        return response;
+    }
+    async createTask({ title, description, userStoryId }) {
+        const task = {
+            "Name": title,
+            "Project": {
+                "Id": config.tp.projectId
+            },
+            "UserStory": {
+                "Id": userStoryId
+            },
+        };
+        if (description) {
+            task["Description"] = description;
+        }
+        return this.post({
+            pathParam: ["Tasks"],
+            param: { "format": "json" },
+        }, task);
+    }
     async addAttachedFile(generalId, source) {
         let blob;
         let fileName;

package/package.json

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