targetprocess-mcp-server 2.2.12 → 2.3.0

package/README.md

@@ -105,6 +105,7 @@ Teams
 User
 - `get_logged_in_user` — Get the currently logged-in user's info (no params needed)
 - `get_users` — Get all Targetprocess users (no params needed)
+- `get_user_by_id` — Get a single Targetprocess user by their ID (id)
 
 Developer Tools
 - `get_commit_message` — Returns a formatted commit message string for a task or bug ID (id, type: task | bug)

package/build/index.js

@@ -435,6 +435,30 @@ server.registerTool('get_bug_content', {
             }],
     };
 });
+server.registerTool('get_user_by_id', {
+    title: 'Get user by id',
+    description: 'Get user by id',
+    inputSchema: {
+        id: z.string()
+            .describe('User email'),
+    },
+}, async ({ id }) => {
+    const user = await tp.getUser(id);
+    if (!user) {
+        return {
+            content: [{
+                    type: 'text',
+                    text: `Failed to get user, id: ${id}\n JSON: ${JSON.stringify(user, null, 2)}`
+                }],
+        };
+    }
+    return {
+        content: [{
+                type: 'text',
+                text: JSON.stringify(user)
+            }],
+    };
+});
 server.registerTool('get_users', {
     title: 'Get users',
     description: 'Get all users',
@@ -1773,6 +1797,161 @@ Formats:
         content: [{ type: 'text', text: `${prefix} ${bug.Name}` }],
     };
 });
+server.registerTool('list_my_user_stories', {
+    title: 'List my user stories',
+    description: 'List User Stories assigned to me. Use this to get an overview of current work. Optionally filter by state.',
+    inputSchema: {
+        state: z.string()
+            .optional()
+            .describe('Filter by state name (e.g. "Open", "In Progress", "Done")'),
+        take: z.number()
+            .default(25)
+            .optional()
+            .describe('Number of results to return, default is 25'),
+        skip: z.number()
+            .default(0)
+            .optional()
+            .describe('Pagination offset, default is 0'),
+    },
+}, async ({ state, take, skip }) => {
+    const response = await tp.getMyUserStories({ state, take, skip });
+    if (!response) {
+        return {
+            content: [{
+                    type: 'text',
+                    text: `Failed to get user stories, JSON: ${JSON.stringify(response, null, 2)}`
+                }],
+        };
+    }
+    const items = response.Items || [];
+    if (items.length === 0) {
+        return {
+            content: [{
+                    type: 'text',
+                    text: `No user stories assigned to you${state ? ` with state "${state}"` : ''}`,
+                }],
+        };
+    }
+    return {
+        content: [{
+                type: 'text',
+                text: JSON.stringify(items)
+            }],
+    };
+});
+server.registerTool('list_my_bugs', {
+    title: 'List my bugs',
+    description: 'List Bugs assigned to me. Optionally filter by state.',
+    inputSchema: {
+        state: z.string()
+            .optional()
+            .describe('Filter by state name (e.g. "Open", "In Progress", "Fixed")'),
+        take: z.number()
+            .default(25)
+            .optional()
+            .describe('Number of results to return, default is 25'),
+        skip: z.number()
+            .default(0)
+            .optional()
+            .describe('Pagination offset, default is 0'),
+    },
+}, async ({ state, take, skip }) => {
+    const response = await tp.getMyBugs({ state, take, skip });
+    if (!response) {
+        return {
+            content: [{
+                    type: 'text',
+                    text: `Failed to get bugs, JSON: ${JSON.stringify(response, null, 2)}`
+                }],
+        };
+    }
+    const items = response.Items || [];
+    if (items.length === 0) {
+        return {
+            content: [{
+                    type: 'text',
+                    text: `No bugs assigned to you${state ? ` with state "${state}"` : ''}`,
+                }],
+        };
+    }
+    return {
+        content: [{
+                type: 'text',
+                text: JSON.stringify(items)
+            }],
+    };
+});
+server.registerTool('log_time', {
+    title: 'Log time on a Task, User Story, or Bug',
+    description: 'Log time spent working on a Task, User Story, or Bug. Call this after completing a task or at the end of a work session.',
+    inputSchema: {
+        entityId: z.string()
+            .min(1)
+            .describe('ID of the Task, User Story, or Bug to log time against (e.g. 145789)'),
+        entityType: z.enum(['Task', 'UserStory', 'Bug'])
+            .describe('Type of the entity'),
+        hours: z.number()
+            .positive()
+            .describe('Hours spent (can be decimal e.g. 1.5)'),
+        description: z.string()
+            .optional()
+            .describe('What was done — brief summary of the work'),
+        date: z.string()
+            .optional()
+            .describe('ISO date string, defaults to today (e.g. "2024-05-21")'),
+    },
+}, async ({ entityId, entityType, hours, description, date }) => {
+    const response = await tp.logTime({ entityId, entityType, hours, description, date });
+    if (!response) {
+        return {
+            content: [{
+                    type: 'text',
+                    text: `Failed to log time on ${entityType} id: ${entityId}`
+                }],
+        };
+    }
+    return {
+        content: [{
+                type: 'text',
+                text: JSON.stringify(response)
+            }],
+    };
+});
+server.registerTool('get_my_time_logs', {
+    title: 'Get my recent time log entries',
+    description: 'Get recent time log entries submitted by me.',
+    inputSchema: {
+        take: z.number()
+            .default(25)
+            .optional()
+            .describe('Number of entries to return, default is 25'),
+    },
+}, async ({ take }) => {
+    const response = await tp.getMyTimeLogs(take);
+    if (!response) {
+        return {
+            content: [{
+                    type: 'text',
+                    text: `Failed to get time logs, JSON: ${JSON.stringify(response, null, 2)}`
+                }],
+        };
+    }
+    const items = response.Items || [];
+    if (items.length === 0) {
+        return {
+            content: [{
+                    type: 'text',
+                    text: `No time logs found`,
+                }],
+        };
+    }
+    return {
+        content: [{
+                type: 'text',
+                text: JSON.stringify(items)
+            }],
+    };
+});
 async function main() {
     const transport = new StdioServerTransport();
     await server.connect(transport);

package/build/tp.js

@@ -310,6 +310,12 @@ export class TpClient {
             param: { "format": "json" },
         }, testPlan);
     }
+    async getUser(userId) {
+        return this.get({
+            pathParam: ["Users", userId],
+            param: { "format": "json" },
+        });
+    }
     async getUsers() {
         return this.get({
             pathParam: ["Users"],
@@ -678,6 +684,65 @@ export class TpClient {
             param: { "format": "json" },
         }, task);
     }
+    async logTime({ entityId, entityType, hours, description, date, }) {
+        const timestamp = date ? new Date(date).getTime() : Date.now();
+        const body = {
+            Spent: hours,
+            Date: `/Date(${timestamp})/`,
+            User: { Id: config.tp.ownerId },
+            Assignable: { Id: entityId, ResourceType: entityType },
+        };
+        if (description)
+            body["Description"] = description;
+        return this.post({
+            pathParam: ["Times"],
+            param: { "format": "json" },
+        }, body);
+    }
+    async getMyTimeLogs(take = 25) {
+        return this.get({
+            pathParam: ["Times"],
+            param: {
+                "format": "json",
+                "where": `User.Id eq ${config.tp.ownerId}`,
+                "include": "[Id,Spent,Date,Description,Assignable[Id,Name,ResourceType]]",
+                "orderByDesc": "Date",
+                "take": take,
+            },
+        });
+    }
+    async getMyUserStories({ state, take = 25, skip = 0 }) {
+        const whereParts = [`AssignedUser.Id eq ${config.tp.ownerId}`];
+        if (state)
+            whereParts.push(`EntityState.Name contains '${state}'`);
+        return this.get({
+            pathParam: ["UserStories"],
+            param: {
+                "format": "json",
+                "where": whereParts.join(' and '),
+                "include": "[Id,Name,EntityState[Name],Effort,Project[Name],Feature[Id,Name],CreateDate,ModifyDate]",
+                "orderByDesc": "ModifyDate",
+                "take": take,
+                "skip": skip,
+            },
+        });
+    }
+    async getMyBugs({ state, take = 25, skip = 0 }) {
+        const whereParts = [`AssignedUser.Id eq ${config.tp.ownerId}`];
+        if (state)
+            whereParts.push(`EntityState.Name contains '${state}'`);
+        return this.get({
+            pathParam: ["Bugs"],
+            param: {
+                "format": "json",
+                "where": whereParts.join(' and '),
+                "include": "[Id,Name,EntityState[Name],Severity[Name],Priority[Name],Project[Name],UserStory[Id,Name],CreateDate,ModifyDate]",
+                "orderByDesc": "ModifyDate",
+                "take": take,
+                "skip": skip,
+            },
+        });
+    }
     async addAttachedFile(generalId, source) {
         let blob;
         let fileName;

package/package.json

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