org-jira-mcp-adapter 1.1.0 → 1.2.1

package/README.md

@@ -22,16 +22,16 @@
       ],
       "env": {
         "JIRA_HOST": "jira.example.com",
-        "JIRA_API_TOKEN": "your_password_or_pat_token"
+        "JIRA_API_TOKEN": "your_pat_token"
       }
     }
   }
 }
 ```
 
-> **Важно**: Замените `jira.example.com` и `your_password_or_pat_token` на ваши реальные данные.
+> **Важно**: Замените `jira.example.com` и `your_pat_token` на ваши реальные данные.
 
 ### Переменные окружения
 
 - `JIRA_HOST`: Адрес вашего Jira сервера (без протокола, например `jira.example.com`).
-- `JIRA_API_TOKEN`: Ваш пароль от Jira или Personal Access Token (PAT).
+- `JIRA_API_TOKEN`: Ваш Personal Access Token (PAT).

package/cleanup_ot_690.js

@@ -0,0 +1,64 @@
+import { JiraService } from './jira-service.js';
+import * as process from 'node:process';
+
+const JIRA_HOST = 'jira.tech.shopstat.ru';
+const JIRA_TOKEN = process.argv[2];
+
+if (!JIRA_TOKEN) {
+    console.error('Please provide Jira API Token as argument: node cleanup_ot_690.js <TOKEN>');
+    process.exit(1);
+}
+
+// Clean host for constructor if needed, but JiraService handles it.
+// Passing JIRA_HOST and JIRA_TOKEN.
+const service = new JiraService(JIRA_HOST, JIRA_TOKEN);
+const issueKey = 'OT-690';
+
+async function main() {
+    console.log(`Starting cleanup for ${issueKey}...`);
+
+    // 1. Delete Worklogs
+    try {
+        console.log('Fetching worklogs...');
+        const worklogsData = await service.getIssueWorklogs(issueKey);
+        // handle both array or object with worklogs property
+        const worklogs = Array.isArray(worklogsData) ? worklogsData : (worklogsData.worklogs || []);
+        
+        console.log(`Found ${worklogs.length} worklogs.`);
+        
+        for (const w of worklogs) {
+            console.log(`Deleting worklog ${w.id}...`);
+            await service.deleteWorklog(issueKey, w.id);
+            console.log(`Deleted worklog ${w.id}`);
+        }
+    } catch (e) {
+        console.error('Error handling worklogs:', e.message);
+        if (e.response) {
+             console.error('Response data:', e.response.data);
+        }
+    }
+
+    // 2. Delete Comments
+    try {
+        console.log('Fetching comments...');
+        const commentsData = await service.getIssueComments(issueKey);
+        const comments = Array.isArray(commentsData) ? commentsData : (commentsData.comments || []);
+        
+        console.log(`Found ${comments.length} comments.`);
+        
+        for (const c of comments) {
+            console.log(`Deleting comment ${c.id}...`);
+            await service.deleteComment(issueKey, c.id);
+            console.log(`Deleted comment ${c.id}`);
+        }
+    } catch (e) {
+        console.error('Error handling comments:', e.message);
+        if (e.response) {
+             console.error('Response data:', e.response.data);
+        }
+    }
+    
+    console.log('Cleanup complete.');
+}
+
+main();

package/index.js

@@ -59,6 +59,36 @@ server.tool("jira_transitionIssue", `Perform a transition on a JIRA issue in the
     return formatToolResponse(result);
 });
 
+server.tool("jira_getVotes", `Get votes for a JIRA issue in the ${jiraInstanceType}`, jiraToolSchemas.getVotes, async ({ issueKey }) => {
+    const result = await jiraService.getVotes(issueKey);
+    return formatToolResponse(result);
+});
+
+server.tool("jira_addVote", `Add vote to a JIRA issue in the ${jiraInstanceType}`, jiraToolSchemas.addVote, async ({ issueKey }) => {
+    const result = await jiraService.addVote(issueKey);
+    return formatToolResponse(result);
+});
+
+server.tool("jira_removeVote", `Remove vote from a JIRA issue in the ${jiraInstanceType}`, jiraToolSchemas.removeVote, async ({ issueKey }) => {
+    const result = await jiraService.removeVote(issueKey);
+    return formatToolResponse(result);
+});
+
+server.tool("jira_getIssueWatchers", `Get watchers for a JIRA issue in the ${jiraInstanceType}`, jiraToolSchemas.getIssueWatchers, async ({ issueKey }) => {
+    const result = await jiraService.getIssueWatchers(issueKey);
+    return formatToolResponse(result);
+});
+
+server.tool("jira_addWatcher", `Add watcher to a JIRA issue in the ${jiraInstanceType}`, jiraToolSchemas.addWatcher, async ({ issueKey, username }) => {
+    const result = await jiraService.addWatcher(issueKey, username);
+    return formatToolResponse(result);
+});
+
+server.tool("jira_removeWatcher", `Remove watcher from a JIRA issue in the ${jiraInstanceType}`, jiraToolSchemas.removeWatcher, async ({ issueKey, username }) => {
+    const result = await jiraService.removeWatcher(issueKey, username);
+    return formatToolResponse(result);
+});
+
 server.tool("jira_addWorklog", `Add a worklog entry to a JIRA issue in the ${jiraInstanceType}`, jiraToolSchemas.addWorklog, async ({ issueKey, timeSpent, comment, started }) => {
     const result = await jiraService.addWorklog(issueKey, timeSpent, comment, started);
     return formatToolResponse(result);
@@ -69,6 +99,16 @@ server.tool("jira_getIssueWorklogs", `Get worklogs for a JIRA issue in the ${jir
     return formatToolResponse(result);
 });
 
+server.tool("jira_deleteWorklog", `Delete a worklog from a JIRA issue in the ${jiraInstanceType}`, jiraToolSchemas.deleteWorklog, async ({ issueKey, worklogId }) => {
+    const result = await jiraService.deleteWorklog(issueKey, worklogId);
+    return formatToolResponse(result);
+});
+
+server.tool("jira_deleteComment", `Delete a comment from a JIRA issue in the ${jiraInstanceType}`, jiraToolSchemas.deleteComment, async ({ issueKey, commentId }) => {
+    const result = await jiraService.deleteComment(issueKey, commentId);
+    return formatToolResponse(result);
+});
+
 server.tool("jira_getAllProjects", `Get all visible projects in the ${jiraInstanceType}`, jiraToolSchemas.getAllProjects, async ({ recent }) => {
     const result = await jiraService.getAllProjects(recent);
     return formatToolResponse(result);

package/jira-service.js

@@ -75,6 +75,61 @@ export class JiraService {
         }, 'Error updating issue');
     }
 
+    async getTransitions(issueKey) {
+        return handleApiOperation(() => IssueService.getTransitions(issueKey), 'Error getting transitions');
+    }
+
+    async transitionIssue(issueKey, transitionId, comment) {
+         return handleApiOperation(() => {
+            const body = {
+                transition: { id: transitionId }
+            };
+            if (comment) {
+                body.update = {
+                    comment: [{
+                        add: { body: comment }
+                    }]
+                };
+            }
+            return IssueService.doTransition(issueKey, body);
+        }, 'Error transitioning issue');
+    }
+    
+    async addWorklog(issueKey, timeSpent, comment, started) {
+        return handleApiOperation(() => {
+            const body = {
+                timeSpent,
+                comment,
+                started: started || new Date().toISOString().replace('Z', '+0000')
+            };
+            return IssueService.addWorklog(issueKey, undefined, undefined, undefined, body);
+        }, 'Error adding worklog');
+    }
+
+    async getIssueWorklogs(issueKey) {
+        return handleApiOperation(() => IssueService.getIssueWorklog(issueKey), 'Error getting worklogs');
+    }
+
+    async deleteWorklog(issueKey, worklogId) {
+        return handleApiOperation(() => IssueService.deleteWorklog(issueKey, worklogId), 'Error deleting worklog');
+    }
+    
+    async deleteComment(issueKey, commentId) {
+        return handleApiOperation(() => IssueService.deleteComment(issueKey, commentId), 'Error deleting comment');
+    }
+
+    async getAllProjects(recent = false) {
+        return handleApiOperation(() => ProjectService.getAllProjects(undefined, undefined, recent ? true : undefined, undefined), 'Error getting projects');
+    }
+
+    async getCurrentUser() {
+        return handleApiOperation(() => MyselfService.getUser(), 'Error getting current user');
+    }
+
+    async findUsers(query, maxResults = 10) {
+        return handleApiOperation(() => GroupuserpickerService.findUsersAndGroups(undefined, maxResults, query, undefined, undefined, undefined), 'Error finding users');
+    }
+
     static validateConfig() {
         const requiredEnvVars = ['JIRA_API_TOKEN'];
         const missingVars = requiredEnvVars.filter(varName => !process.env[varName]);
@@ -99,23 +154,51 @@ export const jiraToolSchemas = {
         expand: z.string().optional().describe("Comma separated fields to expand")
     },
     getTransitions: {
-        issueKey: z.string().describe("JIRA issue key (e.g., PROJ-123)")
-    },
-    transitionIssue: {
-        issueKey: z.string().describe("JIRA issue key (e.g., PROJ-123)"),
-        transitionId: z.string().describe("Transition ID to perform"),
-        comment: z.string().optional().describe("Comment to add with transition")
-    },
-    addWorklog: {
+                issueKey: z.string().describe("JIRA issue key (e.g., PROJ-123)")
+            },
+            transitionIssue: {
+                issueKey: z.string().describe("JIRA issue key (e.g., PROJ-123)"),
+                transitionId: z.string().describe("Transition ID to perform"),
+                comment: z.string().optional().describe("Comment to add with transition")
+            },
+            getVotes: {
+                issueKey: z.string().describe("JIRA issue key (e.g., PROJ-123)")
+            },
+            addVote: {
+                issueKey: z.string().describe("JIRA issue key (e.g., PROJ-123)")
+            },
+            removeVote: {
+                issueKey: z.string().describe("JIRA issue key (e.g., PROJ-123)")
+            },
+            getIssueWatchers: {
+                issueKey: z.string().describe("JIRA issue key (e.g., PROJ-123)")
+            },
+            addWatcher: {
+                issueKey: z.string().describe("JIRA issue key (e.g., PROJ-123)"),
+                username: z.string().optional().describe("Username to add as watcher (defaults to current user)")
+            },
+            removeWatcher: {
+                issueKey: z.string().describe("JIRA issue key (e.g., PROJ-123)"),
+                username: z.string().describe("Username to remove from watchers")
+            },
+            addWorklog: {
         issueKey: z.string().describe("JIRA issue key (e.g., PROJ-123)"),
         timeSpent: z.string().describe("Time spent (e.g. 1h 30m)"),
         comment: z.string().optional().describe("Worklog comment"),
         started: z.string().optional().describe("Start time (ISO 8601 string), defaults to now")
     },
     getIssueWorklogs: {
-        issueKey: z.string().describe("JIRA issue key (e.g., PROJ-123)")
-    },
-    getAllProjects: {
+                issueKey: z.string().describe("JIRA issue key (e.g., PROJ-123)")
+            },
+            deleteWorklog: {
+                issueKey: z.string().describe("JIRA issue key (e.g., PROJ-123)"),
+                worklogId: z.string().describe("ID of the worklog to delete")
+            },
+            deleteComment: {
+                issueKey: z.string().describe("JIRA issue key (e.g., PROJ-123)"),
+                commentId: z.string().describe("ID of the comment to delete")
+            },
+            getAllProjects: {
         recent: z.boolean().optional().describe("Return only recent projects")
     },
     getCurrentUser: {},

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "org-jira-mcp-adapter",
-  "version": "1.1.0",
+  "version": "1.2.1",
   "description": "MCP server for Jira Data Center/Server (On-Premise)",
   "type": "module",
   "main": "index.js",