org-jira-mcp-adapter 1.0.0 → 1.2.0

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

@@ -49,4 +49,79 @@ server.tool("jira_postIssueComment", `Post a comment on a JIRA issue in the ${ji
     return formatToolResponse(result);
 });
 
+server.tool("jira_getTransitions", `Get available transitions for a JIRA issue in the ${jiraInstanceType}`, jiraToolSchemas.getTransitions, async ({ issueKey }) => {
+    const result = await jiraService.getTransitions(issueKey);
+    return formatToolResponse(result);
+});
+
+server.tool("jira_transitionIssue", `Perform a transition on a JIRA issue in the ${jiraInstanceType}`, jiraToolSchemas.transitionIssue, async ({ issueKey, transitionId, comment }) => {
+    const result = await jiraService.transitionIssue(issueKey, transitionId, comment);
+    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);
+});
+
+server.tool("jira_getIssueWorklogs", `Get worklogs for a JIRA issue in the ${jiraInstanceType}`, jiraToolSchemas.getIssueWorklogs, async ({ issueKey }) => {
+    const result = await jiraService.getIssueWorklogs(issueKey);
+    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);
+});
+
+server.tool("jira_getCurrentUser", `Get the currently logged in user in the ${jiraInstanceType}`, jiraToolSchemas.getCurrentUser, async () => {
+    const result = await jiraService.getCurrentUser();
+    return formatToolResponse(result);
+});
+
+server.tool("jira_findUsers", `Find users in the ${jiraInstanceType}`, jiraToolSchemas.findUsers, async ({ query, maxResults }) => {
+    const result = await jiraService.findUsers(query, maxResults);
+    return formatToolResponse(result);
+});
+
 await connectServer(server);

package/jira-service.js

@@ -3,19 +3,14 @@ import { handleApiOperation } from '@atlassian-dc-mcp/common';
 import { IssueService, OpenAPI, SearchService } from '@atlassian-dc-mcp/jira/build/jira-client/index.js';
 
 export class JiraService {
-    constructor(host, token, fullBaseUrl, email) {
+    constructor(host, token, fullBaseUrl) {
         if (fullBaseUrl) {
             OpenAPI.BASE = fullBaseUrl;
         } else if (host) {
             const cleanHost = host.replace(/^https?:\/\//, '').replace(/\/$/, '');
             OpenAPI.BASE = `https://${cleanHost}/rest`;
         }
-        if (email) {
-            OpenAPI.USERNAME = email;
-            OpenAPI.PASSWORD = token;
-        } else {
-            OpenAPI.TOKEN = token;
-        }
+        OpenAPI.TOKEN = token;
         OpenAPI.VERSION = '2';
     }
 
@@ -80,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]);
@@ -103,6 +153,59 @@ export const jiraToolSchemas = {
         issueKey: z.string().describe("JIRA issue key (e.g., PROJ-123)"),
         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")
+            },
+            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)")
+            },
+            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: {},
+    findUsers: {
+        query: z.string().describe("Search query (username, name, email)"),
+        maxResults: z.number().optional().describe("Max results")
+    },
     getIssueComments: {
         issueKey: z.string().describe("JIRA issue key (e.g., PROJ-123)"),
         expand: z.string().optional().describe("Comma separated fields to expand")

package/package.json

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