@khanglvm/jira-mcp 1.3.0

package/dist/tools/issues.js

@@ -0,0 +1,392 @@
+/**
+ * @file tools/issues.ts
+ * @description Issue-related MCP tools for Jira.
+ * Provides tools for creating, reading, updating, and deleting issues.
+ */
+import { z } from 'zod';
+/**
+ * Schema for get_issue tool input.
+ */
+export const getIssueSchema = z.object({
+    issueKey: z.string().describe('The issue key (e.g., "PROJ-123") or ID'),
+    fields: z
+        .string()
+        .optional()
+        .describe('Comma-separated list of fields to return'),
+});
+/**
+ * Schema for create_issue tool input.
+ */
+export const createIssueSchema = z.object({
+    projectKey: z.string().describe('The project key (e.g., "PROJ")'),
+    summary: z.string().describe('Issue summary/title'),
+    issueType: z
+        .string()
+        .default('Task')
+        .describe('Issue type name (e.g., "Bug", "Task", "Story")'),
+    description: z.string().optional().describe('Issue description'),
+    assignee: z.string().optional().describe('Assignee username'),
+    priority: z.string().optional().describe('Priority name (e.g., "High", "Medium")'),
+    labels: z.array(z.string()).optional().describe('Array of labels'),
+});
+/**
+ * Schema for update_issue tool input.
+ */
+export const updateIssueSchema = z.object({
+    issueKey: z.string().describe('The issue key or ID to update'),
+    summary: z.string().optional().describe('New summary'),
+    description: z.string().optional().describe('New description'),
+    assignee: z
+        .string()
+        .optional()
+        .nullable()
+        .describe('New assignee username (null to unassign)'),
+    priority: z.string().optional().describe('New priority name'),
+    labels: z.array(z.string()).optional().describe('New labels array'),
+});
+/**
+ * Schema for delete_issue tool input.
+ */
+export const deleteIssueSchema = z.object({
+    issueKey: z.string().describe('The issue key or ID to delete'),
+    deleteSubtasks: z
+        .boolean()
+        .default(false)
+        .describe('Whether to also delete subtasks'),
+});
+/**
+ * Schema for add_comment tool input.
+ */
+export const addCommentSchema = z.object({
+    issueKey: z.string().describe('The issue key or ID'),
+    body: z.string().describe('Comment body text'),
+});
+/**
+ * Schema for get_comments tool input.
+ */
+export const getCommentsSchema = z.object({
+    issueKey: z.string().describe('The issue key or ID'),
+});
+/**
+ * Creates issue tool handlers.
+ * @param client - Jira client instance
+ * @returns Object containing all issue tool handlers
+ */
+export function createIssueTools(client) {
+    return {
+        /**
+         * Gets an issue by key or ID.
+         */
+        jira_get_issue: async (args) => {
+            const issue = await client.getIssue(args.issueKey, args.fields);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            key: issue.key,
+                            id: issue.id,
+                            summary: issue.fields.summary,
+                            description: issue.fields.description,
+                            status: issue.fields.status.name,
+                            priority: issue.fields.priority?.name,
+                            assignee: issue.fields.assignee?.displayName,
+                            reporter: issue.fields.reporter?.displayName,
+                            issueType: issue.fields.issuetype.name,
+                            project: issue.fields.project.key,
+                            labels: issue.fields.labels,
+                            created: issue.fields.created,
+                            updated: issue.fields.updated,
+                        }, null, 2),
+                    },
+                ],
+            };
+        },
+        /**
+         * Creates a new issue.
+         */
+        jira_create_issue: async (args) => {
+            const result = await client.createIssue({
+                project: { key: args.projectKey },
+                summary: args.summary,
+                issuetype: { name: args.issueType },
+                description: args.description,
+                assignee: args.assignee ? { name: args.assignee } : undefined,
+                priority: args.priority ? { name: args.priority } : undefined,
+                labels: args.labels,
+            });
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            success: true,
+                            key: result.key,
+                            id: result.id,
+                            self: result.self,
+                        }, null, 2),
+                    },
+                ],
+            };
+        },
+        /**
+         * Updates an existing issue.
+         */
+        jira_update_issue: async (args) => {
+            await client.updateIssue(args.issueKey, {
+                summary: args.summary,
+                description: args.description,
+                assignee: args.assignee === null ? null : args.assignee ? { name: args.assignee } : undefined,
+                priority: args.priority ? { name: args.priority } : undefined,
+                labels: args.labels,
+            });
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            success: true,
+                            message: `Issue ${args.issueKey} updated successfully`,
+                        }, null, 2),
+                    },
+                ],
+            };
+        },
+        /**
+         * Deletes an issue.
+         */
+        jira_delete_issue: async (args) => {
+            await client.deleteIssue(args.issueKey, args.deleteSubtasks);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            success: true,
+                            message: `Issue ${args.issueKey} deleted successfully`,
+                        }, null, 2),
+                    },
+                ],
+            };
+        },
+        /**
+         * Adds a comment to an issue.
+         */
+        jira_add_comment: async (args) => {
+            const comment = await client.addComment(args.issueKey, args.body);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            success: true,
+                            commentId: comment.id,
+                            author: comment.author.displayName,
+                            created: comment.created,
+                        }, null, 2),
+                    },
+                ],
+            };
+        },
+        /**
+         * Gets comments on an issue.
+         */
+        jira_get_comments: async (args) => {
+            const result = await client.getComments(args.issueKey);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            total: result.total,
+                            comments: result.comments.map((c) => ({
+                                id: c.id,
+                                author: c.author.displayName,
+                                body: c.body,
+                                created: c.created,
+                                updated: c.updated,
+                            })),
+                        }, null, 2),
+                    },
+                ],
+            };
+        },
+    };
+}
+/**
+ * Tool definitions for issue-related operations.
+ * Semantic descriptions help AI understand when to use each tool.
+ */
+export const issueToolDefinitions = [
+    {
+        name: 'jira_get_issue',
+        description: `Retrieve full details of a specific Jira issue. Use when user:
+- Asks about a specific ticket by key (PROJ-123) or ID
+- Wants to see issue details, description, status, or assignee
+- Needs information about a particular work item
+
+Returns: summary, description, status, priority, assignee, reporter, labels, dates.`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                issueKey: {
+                    type: 'string',
+                    description: 'Issue key like PROJ-123 or numeric ID',
+                },
+                fields: {
+                    type: 'string',
+                    description: 'Comma-separated fields to return (optional)',
+                },
+            },
+            required: ['issueKey'],
+        },
+    },
+    {
+        name: 'jira_create_issue',
+        description: `Create a new issue in Jira. Use when user wants to:
+- Log a bug, task, story, or any work item
+- Report a problem or request a feature
+- Create a ticket for new work
+- Add something to the backlog
+
+Defaults to 'Task' type. Common types: Bug, Task, Story, Epic, Sub-task.`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                projectKey: {
+                    type: 'string',
+                    description: 'Project key like "PROJ"',
+                },
+                summary: {
+                    type: 'string',
+                    description: 'Issue title/summary',
+                },
+                issueType: {
+                    type: 'string',
+                    description: 'Type: Bug, Task, Story, Epic (default: Task)',
+                    default: 'Task',
+                },
+                description: {
+                    type: 'string',
+                    description: 'Detailed description',
+                },
+                assignee: {
+                    type: 'string',
+                    description: 'Username to assign to',
+                },
+                priority: {
+                    type: 'string',
+                    description: 'Priority: Highest, High, Medium, Low, Lowest',
+                },
+                labels: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Labels to add',
+                },
+            },
+            required: ['projectKey', 'summary'],
+        },
+    },
+    {
+        name: 'jira_update_issue',
+        description: `Update an existing Jira issue. Use when user wants to:
+- Change issue summary, description, or priority
+- Reassign to someone else or unassign
+- Update labels or other fields
+- Modify ticket details`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                issueKey: {
+                    type: 'string',
+                    description: 'Issue key like PROJ-123',
+                },
+                summary: {
+                    type: 'string',
+                    description: 'New summary/title',
+                },
+                description: {
+                    type: 'string',
+                    description: 'New description',
+                },
+                assignee: {
+                    type: ['string', 'null'],
+                    description: 'New assignee username (null to unassign)',
+                },
+                priority: {
+                    type: 'string',
+                    description: 'New priority level',
+                },
+                labels: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'New labels (replaces existing)',
+                },
+            },
+            required: ['issueKey'],
+        },
+    },
+    {
+        name: 'jira_delete_issue',
+        description: `Delete a Jira issue permanently. Use when user explicitly asks to:
+- Delete or remove an issue
+- Permanently remove a ticket
+
+WARNING: This permanently deletes the issue. Consider transitioning to Closed instead.`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                issueKey: {
+                    type: 'string',
+                    description: 'Issue key to delete',
+                },
+                deleteSubtasks: {
+                    type: 'boolean',
+                    description: 'Also delete subtasks (default: false)',
+                    default: false,
+                },
+            },
+            required: ['issueKey'],
+        },
+    },
+    {
+        name: 'jira_add_comment',
+        description: `Add a comment to a Jira issue. Use when user wants to:
+- Comment on a ticket
+- Add notes or feedback to an issue
+- Leave a message on a work item
+- Document something on a ticket`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                issueKey: {
+                    type: 'string',
+                    description: 'Issue key to comment on',
+                },
+                body: {
+                    type: 'string',
+                    description: 'Comment text',
+                },
+            },
+            required: ['issueKey', 'body'],
+        },
+    },
+    {
+        name: 'jira_get_comments',
+        description: `Get all comments on a Jira issue. Use when user wants to:
+- See comments or discussion on a ticket
+- Review feedback on an issue
+- Check what was said on a work item`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                issueKey: {
+                    type: 'string',
+                    description: 'Issue key to get comments from',
+                },
+            },
+            required: ['issueKey'],
+        },
+    },
+];
+//# sourceMappingURL=issues.js.map

package/dist/tools/issues.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"issues.js","sourceRoot":"","sources":["../../src/tools/issues.ts"],"names":[],"mappings":"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"}

package/dist/tools/projects.d.ts

@@ -0,0 +1,70 @@
+/**
+ * @file tools/projects.ts
+ * @description Project-related MCP tools for Jira.
+ */
+import { z } from 'zod';
+import { JiraClient } from '../client.js';
+/**
+ * Schema for get_project tool input.
+ */
+export declare const getProjectSchema: z.ZodObject<{
+    projectKey: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    projectKey: string;
+}, {
+    projectKey: string;
+}>;
+/**
+ * Creates project tool handlers.
+ * @param client - Jira client instance
+ * @returns Object containing project tool handlers
+ */
+export declare function createProjectTools(client: JiraClient): {
+    /**
+     * Lists all accessible projects.
+     */
+    jira_list_projects: () => Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+    /**
+     * Gets a project by key or ID.
+     */
+    jira_get_project: (args: z.infer<typeof getProjectSchema>) => Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+};
+/**
+ * Tool definitions for project operations.
+ * Semantic descriptions help AI understand project browsing.
+ */
+export declare const projectToolDefinitions: ({
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            projectKey?: undefined;
+        };
+        required: never[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            projectKey: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+})[];
+//# sourceMappingURL=projects.d.ts.map

package/dist/tools/projects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projects.d.ts","sourceRoot":"","sources":["../../src/tools/projects.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;;;EAE3B,CAAC;AAEH;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,UAAU;IAE7C;;OAEG;;;;;;;IA0BH;;OAEG;6BAC4B,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC;;;;;;EAuBtE;AAED;;;GAGG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;IA+BlC,CAAC"}

package/dist/tools/projects.js

@@ -0,0 +1,101 @@
+/**
+ * @file tools/projects.ts
+ * @description Project-related MCP tools for Jira.
+ */
+import { z } from 'zod';
+/**
+ * Schema for get_project tool input.
+ */
+export const getProjectSchema = z.object({
+    projectKey: z.string().describe('The project key (e.g., "PROJ") or ID'),
+});
+/**
+ * Creates project tool handlers.
+ * @param client - Jira client instance
+ * @returns Object containing project tool handlers
+ */
+export function createProjectTools(client) {
+    return {
+        /**
+         * Lists all accessible projects.
+         */
+        jira_list_projects: async () => {
+            const projects = await client.getProjects();
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            total: projects.length,
+                            projects: projects.map((p) => ({
+                                key: p.key,
+                                name: p.name,
+                                id: p.id,
+                                projectType: p.projectTypeKey,
+                                lead: p.lead?.displayName,
+                            })),
+                        }, null, 2),
+                    },
+                ],
+            };
+        },
+        /**
+         * Gets a project by key or ID.
+         */
+        jira_get_project: async (args) => {
+            const project = await client.getProject(args.projectKey);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            key: project.key,
+                            name: project.name,
+                            id: project.id,
+                            description: project.description,
+                            projectType: project.projectTypeKey,
+                            lead: project.lead?.displayName,
+                        }, null, 2),
+                    },
+                ],
+            };
+        },
+    };
+}
+/**
+ * Tool definitions for project operations.
+ * Semantic descriptions help AI understand project browsing.
+ */
+export const projectToolDefinitions = [
+    {
+        name: 'jira_list_projects',
+        description: `List all Jira projects accessible to the user. Use when user wants to:
+- See available projects
+- Find a project key
+- Browse what projects exist
+- Get project list for searching issues`,
+        inputSchema: {
+            type: 'object',
+            properties: {},
+            required: [],
+        },
+    },
+    {
+        name: 'jira_get_project',
+        description: `Get details of a specific Jira project. Use when user wants to:
+- Get info about a project by key
+- See project description or lead
+- Check project details`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                projectKey: {
+                    type: 'string',
+                    description: 'Project key like "PROJ"',
+                },
+            },
+            required: ['projectKey'],
+        },
+    },
+];
+//# sourceMappingURL=projects.js.map

package/dist/tools/projects.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projects.js","sourceRoot":"","sources":["../../src/tools/projects.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sCAAsC,CAAC;CAC1E,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAkB;IACjD,OAAO;QACH;;WAEG;QACH,kBAAkB,EAAE,KAAK,IAAI,EAAE;YAC3B,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,WAAW,EAAE,CAAC;YAC5C,OAAO;gBACH,OAAO,EAAE;oBACL;wBACI,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAChB;4BACI,KAAK,EAAE,QAAQ,CAAC,MAAM;4BACtB,QAAQ,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gCAC3B,GAAG,EAAE,CAAC,CAAC,GAAG;gCACV,IAAI,EAAE,CAAC,CAAC,IAAI;gCACZ,EAAE,EAAE,CAAC,CAAC,EAAE;gCACR,WAAW,EAAE,CAAC,CAAC,cAAc;gCAC7B,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,WAAW;6BAC5B,CAAC,CAAC;yBACN,EACD,IAAI,EACJ,CAAC,CACJ;qBACJ;iBACJ;aACJ,CAAC;QACN,CAAC;QAED;;WAEG;QACH,gBAAgB,EAAE,KAAK,EAAE,IAAsC,EAAE,EAAE;YAC/D,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YACzD,OAAO;gBACH,OAAO,EAAE;oBACL;wBACI,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAChB;4BACI,GAAG,EAAE,OAAO,CAAC,GAAG;4BAChB,IAAI,EAAE,OAAO,CAAC,IAAI;4BAClB,EAAE,EAAE,OAAO,CAAC,EAAE;4BACd,WAAW,EAAE,OAAO,CAAC,WAAW;4BAChC,WAAW,EAAE,OAAO,CAAC,cAAc;4BACnC,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,WAAW;yBAClC,EACD,IAAI,EACJ,CAAC,CACJ;qBACJ;iBACJ;aACJ,CAAC;QACN,CAAC;KACJ,CAAC;AACN,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG;IAClC;QACI,IAAI,EAAE,oBAAoB;QAC1B,WAAW,EAAE;;;;wCAImB;QAChC,WAAW,EAAE;YACT,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE,EAAE;YACd,QAAQ,EAAE,EAAE;SACf;KACJ;IACD;QACI,IAAI,EAAE,kBAAkB;QACxB,WAAW,EAAE;;;wBAGG;QAChB,WAAW,EAAE;YACT,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE;gBACR,UAAU,EAAE;oBACR,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,yBAAyB;iBACzC;aACJ;YACD,QAAQ,EAAE,CAAC,YAAY,CAAC;SAC3B;KACJ;CACJ,CAAC"}

package/dist/tools/search.d.ts

@@ -0,0 +1,76 @@
+/**
+ * @file tools/search.ts
+ * @description JQL search tool for Jira MCP.
+ */
+import { z } from 'zod';
+import { JiraClient } from '../client.js';
+/**
+ * Schema for search tool input.
+ */
+export declare const searchSchema: z.ZodObject<{
+    jql: z.ZodString;
+    maxResults: z.ZodDefault<z.ZodNumber>;
+    startAt: z.ZodDefault<z.ZodNumber>;
+    fields: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    jql: string;
+    maxResults: number;
+    startAt: number;
+    fields?: string[] | undefined;
+}, {
+    jql: string;
+    fields?: string[] | undefined;
+    maxResults?: number | undefined;
+    startAt?: number | undefined;
+}>;
+/**
+ * Creates search tool handlers.
+ * @param client - Jira client instance
+ * @returns Object containing search tool handler
+ */
+export declare function createSearchTools(client: JiraClient): {
+    /**
+     * Searches for issues using JQL.
+     */
+    jira_search: (args: z.infer<typeof searchSchema>) => Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+};
+/**
+ * Tool definitions for search operations.
+ */
+export declare const searchToolDefinitions: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            jql: {
+                type: string;
+                description: string;
+            };
+            maxResults: {
+                type: string;
+                description: string;
+                default: number;
+            };
+            startAt: {
+                type: string;
+                description: string;
+                default: number;
+            };
+            fields: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+        };
+        required: string[];
+    };
+}[];
+//# sourceMappingURL=search.d.ts.map

package/dist/tools/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/tools/search.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C;;GAEG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;EAmBvB,CAAC;AAEH;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,UAAU;IAE5C;;OAEG;wBACuB,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC;;;;;;EAiC7D;AAED;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CjC,CAAC"}