targetprocess-mcp-server 2.5.0 → 2.5.2

package/README.md

@@ -132,6 +132,11 @@ Time Tracking
 - `log_time` — Log time spent on a Task, User Story, or Bug (entityId, entityType: Task | UserStory | Bug, hours, optional description, optional date)
 - `get_my_time_logs` — Get recent time log entries submitted by the current user (optional take)
 
+Assignments
+- `assign_role` — Assign a user to a role (e.g. Business Analyst, Developer, QA Engineer) on a TP card (cardId, userId, roleId)
+- `assign_role_to_feature` — Assign a user to a role on all user stories in a feature in one call (featureId, userId, roleId)
+- `get_assignment_roles` — List all available assignment roles with their IDs
+
 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>`

package/build/handlers/get_release_bugs.js

@@ -1,5 +1,5 @@
-export async function handleGetReleaseBugs(tp, name, results) {
-    const release = await tp.getReleaseBugs({ name, results });
+export async function handleGetReleaseBugs(tp, name, results, withDescription) {
+    const release = await tp.getReleaseBugs({ name, results, withDescription });
     if (!release) {
         return {
             content: [{

package/build/index.js

@@ -2,6 +2,7 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { z } from "zod";
 import { JSDOM } from "jsdom";
+import { createRequire } from "module";
 import { TpClient } from "./tp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { config } from "./config.js";
@@ -97,8 +98,10 @@ server.registerTool('get_release_bugs', {
             .default(100)
             .optional()
             .describe('Number of results to return, default is 100'),
+        withDescription: z.boolean()
+            .describe('Include description in the response'),
     },
-}, async ({ name, results }) => handleGetReleaseBugs(tp, name, results));
+}, async ({ name, results, withDescription }) => handleGetReleaseBugs(tp, name, results, withDescription));
 server.registerTool('get_release_features', {
     title: 'Get release features',
     description: 'Get release features',
@@ -478,9 +481,12 @@ server.registerTool('update_user_story', {
         entityStateId: z.string()
             .optional()
             .describe('Optional Entity State ID — if user gave a state name, resolve it via "get_user_story_workflows" first'),
+        featureId: z.string()
+            .optional()
+            .describe('Optional Feature ID — moves this user story to the specified feature'),
     },
-}, async ({ id, title, description, projectId, teamId, entityStateId }) => {
-    const response = await tp.updateUserStory({ id, title, description, projectId, teamId, entityStateId });
+}, async ({ id, title, description, projectId, teamId, entityStateId, featureId }) => {
+    const response = await tp.updateUserStory({ id, title, description, projectId, teamId, entityStateId, featureId });
     if (!response) {
         return {
             content: [{
@@ -1447,6 +1453,15 @@ server.registerTool('get_my_time_logs', {
             .describe('Number of entries to return, default is 25'),
     },
 }, async ({ take }) => handleGetMyTimeLogs(tp, take));
+const require = createRequire(import.meta.url);
+const { version } = require("../package.json");
+server.registerTool('get_version', {
+    title: 'Get server version',
+    description: 'Returns the current version of the MCP server from package.json.',
+    inputSchema: {},
+}, async () => ({
+    content: [{ type: "text", text: version }]
+}));
 async function main() {
     const transport = new StdioServerTransport();
     await server.connect(transport);

package/build/tp.js

@@ -45,6 +45,7 @@ export class TpClient {
     async get(params) {
         params.param["access_token"] = this.token;
         let _url = this.params(params);
+        console.error(JSON.stringify({ "TP_GET_URL": _url }));
         try {
             const response = await fetch(_url, {
                 method: "GET",
@@ -197,7 +198,7 @@ export class TpClient {
             param: { "format": "json" },
         }, userStory);
     }
-    async updateUserStory({ id, title, description, projectId, teamId, entityStateId }) {
+    async updateUserStory({ id, title, description, projectId, teamId, entityStateId, featureId }) {
         const userStory = { "Id": id };
         if (title)
             userStory["Name"] = title;
@@ -209,6 +210,8 @@ export class TpClient {
             userStory["assignedTeams"] = [{ "team": { "id": teamId } }];
         if (entityStateId)
             userStory["EntityState"] = { "Id": entityStateId };
+        if (featureId)
+            userStory["Feature"] = { "Id": featureId };
         return this.post({
             pathParam: ["UserStories"],
             param: { "format": "json" },
@@ -564,8 +567,8 @@ export class TpClient {
             }
         });
     }
-    async getReleaseBugs({ name, results = 100, withDescription = false }) {
-        const includeFilter = withDescription ? "[Name, Description, Id]" : "[Name, Id]";
+    async getReleaseBugs({ name, results = 500, withDescription = false }) {
+        const includeFilter = withDescription ? "[Name, Description, Id, Creator, Owner, Team]" : "[Name, Id]";
         return this.get({
             pathParam: ["Bugs"],
             param: {
@@ -818,6 +821,38 @@ export class TpClient {
             param: { "format": "json" },
         }, body);
     }
+    async assignRole(cardId, userId, roleId) {
+        return this.post({
+            pathParam: ["Assignments"],
+            param: { "format": "json" },
+        }, {
+            Assignable: { Id: parseInt(cardId) },
+            GeneralUser: { Id: parseInt(userId) },
+            Role: { Id: parseInt(roleId) },
+        });
+    }
+    async assignRoleToAllStoriesInFeature(featureId, userId, roleId) {
+        const storiesResponse = await this.getFeatureUserStories(featureId);
+        const storyItems = storiesResponse?.items?.[0]?.userStories?.items ?? [];
+        const succeeded = [];
+        const failed = [];
+        await Promise.all(storyItems.map(async (story) => {
+            const result = await this.assignRole(String(story.id), userId, roleId);
+            if (result) {
+                succeeded.push(result);
+            }
+            else {
+                failed.push(story.id);
+            }
+        }));
+        return { succeeded, failed };
+    }
+    async getAssignmentRoles() {
+        return this.get({
+            pathParam: ["Roles"],
+            param: { "format": "json" },
+        });
+    }
     async getMyTimeLogs(take = 25) {
         return this.get({
             pathParam: ["Times"],

package/package.json

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