@lvmk/jira-mcp 1.0.0

package/dist/tools/issues.js

@@ -0,0 +1,365 @@
+/**
+ * @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.
+ */
+export const issueToolDefinitions = [
+    {
+        name: 'jira_get_issue',
+        description: 'Get details of a Jira issue by its key or ID',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                issueKey: {
+                    type: 'string',
+                    description: 'The issue key (e.g., "PROJ-123") or ID',
+                },
+                fields: {
+                    type: 'string',
+                    description: 'Comma-separated list of fields to return',
+                },
+            },
+            required: ['issueKey'],
+        },
+    },
+    {
+        name: 'jira_create_issue',
+        description: 'Create a new Jira issue',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                projectKey: {
+                    type: 'string',
+                    description: 'The project key (e.g., "PROJ")',
+                },
+                summary: {
+                    type: 'string',
+                    description: 'Issue summary/title',
+                },
+                issueType: {
+                    type: 'string',
+                    description: 'Issue type name (e.g., "Bug", "Task", "Story")',
+                    default: 'Task',
+                },
+                description: {
+                    type: 'string',
+                    description: 'Issue description',
+                },
+                assignee: {
+                    type: 'string',
+                    description: 'Assignee username',
+                },
+                priority: {
+                    type: 'string',
+                    description: 'Priority name (e.g., "High", "Medium")',
+                },
+                labels: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Array of labels',
+                },
+            },
+            required: ['projectKey', 'summary'],
+        },
+    },
+    {
+        name: 'jira_update_issue',
+        description: 'Update an existing Jira issue',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                issueKey: {
+                    type: 'string',
+                    description: 'The issue key or ID to update',
+                },
+                summary: {
+                    type: 'string',
+                    description: 'New summary',
+                },
+                description: {
+                    type: 'string',
+                    description: 'New description',
+                },
+                assignee: {
+                    type: ['string', 'null'],
+                    description: 'New assignee username (null to unassign)',
+                },
+                priority: {
+                    type: 'string',
+                    description: 'New priority name',
+                },
+                labels: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'New labels array',
+                },
+            },
+            required: ['issueKey'],
+        },
+    },
+    {
+        name: 'jira_delete_issue',
+        description: 'Delete a Jira issue',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                issueKey: {
+                    type: 'string',
+                    description: 'The issue key or ID to delete',
+                },
+                deleteSubtasks: {
+                    type: 'boolean',
+                    description: 'Whether to also delete subtasks',
+                    default: false,
+                },
+            },
+            required: ['issueKey'],
+        },
+    },
+    {
+        name: 'jira_add_comment',
+        description: 'Add a comment to a Jira issue',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                issueKey: {
+                    type: 'string',
+                    description: 'The issue key or ID',
+                },
+                body: {
+                    type: 'string',
+                    description: 'Comment body text',
+                },
+            },
+            required: ['issueKey', 'body'],
+        },
+    },
+    {
+        name: 'jira_get_comments',
+        description: 'Get all comments on a Jira issue',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                issueKey: {
+                    type: 'string',
+                    description: 'The issue key or ID',
+                },
+            },
+            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,69 @@
+/**
+ * @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.
+ */
+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;;GAEG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;IAwBlC,CAAC"}

package/dist/tools/projects.js

@@ -0,0 +1,93 @@
+/**
+ * @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.
+ */
+export const projectToolDefinitions = [
+    {
+        name: 'jira_list_projects',
+        description: 'List all Jira projects accessible to the authenticated user',
+        inputSchema: {
+            type: 'object',
+            properties: {},
+            required: [],
+        },
+    },
+    {
+        name: 'jira_get_project',
+        description: 'Get details of a specific Jira project',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                projectKey: {
+                    type: 'string',
+                    description: 'The project key (e.g., "PROJ") or ID',
+                },
+            },
+            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;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG;IAClC;QACI,IAAI,EAAE,oBAAoB;QAC1B,WAAW,EAAE,6DAA6D;QAC1E,WAAW,EAAE;YACT,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE,EAAE;YACd,QAAQ,EAAE,EAAE;SACf;KACJ;IACD;QACI,IAAI,EAAE,kBAAkB;QACxB,WAAW,EAAE,wCAAwC;QACrD,WAAW,EAAE;YACT,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE;gBACR,UAAU,EAAE;oBACR,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,sCAAsC;iBACtD;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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BjC,CAAC"}