@khanglvm/jira-mcp 1.3.0

package/dist/tools/search.js

@@ -0,0 +1,111 @@
+/**
+ * @file tools/search.ts
+ * @description JQL search tool for Jira MCP.
+ */
+import { z } from 'zod';
+/**
+ * Schema for search tool input.
+ */
+export const searchSchema = z.object({
+    jql: z.string().describe('JQL query string (e.g., "project = PROJ AND status = Open")'),
+    maxResults: z
+        .number()
+        .int()
+        .min(1)
+        .max(100)
+        .default(50)
+        .describe('Maximum number of results to return (1-100)'),
+    startAt: z
+        .number()
+        .int()
+        .min(0)
+        .default(0)
+        .describe('Starting index for pagination'),
+    fields: z
+        .array(z.string())
+        .optional()
+        .describe('Fields to include in results'),
+});
+/**
+ * Creates search tool handlers.
+ * @param client - Jira client instance
+ * @returns Object containing search tool handler
+ */
+export function createSearchTools(client) {
+    return {
+        /**
+         * Searches for issues using JQL.
+         */
+        jira_search: async (args) => {
+            const result = await client.search(args.jql, args.maxResults, args.startAt, args.fields);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            total: result.total,
+                            startAt: result.startAt,
+                            maxResults: result.maxResults,
+                            issues: result.issues.map((issue) => ({
+                                key: issue.key,
+                                summary: issue.fields.summary,
+                                status: issue.fields.status.name,
+                                assignee: issue.fields.assignee?.displayName,
+                                priority: issue.fields.priority?.name,
+                                issueType: issue.fields.issuetype.name,
+                            })),
+                        }, null, 2),
+                    },
+                ],
+            };
+        },
+    };
+}
+/**
+ * Tool definitions for search operations.
+ */
+export const searchToolDefinitions = [
+    {
+        name: 'jira_search',
+        description: `Find Jira issues matching specific criteria. Use when user asks to:
+- Find, list, or show issues (bugs, tasks, stories, epics)
+- Search for work by status, assignee, project, priority, or date
+- Get open, closed, in-progress, or unassigned items
+- Find "my tasks" or someone else's work
+- List recent or updated issues
+
+Build JQL from natural language requests:
+- "my open bugs" → assignee = currentUser() AND type = Bug AND status != Done
+- "high priority tasks in PROJECT" → project = PROJECT AND type = Task AND priority = High
+- "issues updated this week" → updated >= startOfWeek()
+- "unassigned bugs" → assignee IS EMPTY AND type = Bug
+
+Common JQL fields: project, status, assignee, reporter, priority, type, created, updated, due`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                jql: {
+                    type: 'string',
+                    description: 'JQL query. Examples: "project = PROJ AND status = Open", "assignee = currentUser() AND type = Bug"',
+                },
+                maxResults: {
+                    type: 'number',
+                    description: 'Max results (1-100, default 50)',
+                    default: 50,
+                },
+                startAt: {
+                    type: 'number',
+                    description: 'Pagination offset (default 0)',
+                    default: 0,
+                },
+                fields: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Fields to include in results',
+                },
+            },
+            required: ['jql'],
+        },
+    },
+];
+//# sourceMappingURL=search.js.map

package/dist/tools/search.js.map

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

package/dist/tools/transitions.d.ts

@@ -0,0 +1,99 @@
+/**
+ * @file tools/transitions.ts
+ * @description Workflow transition tools for Jira MCP.
+ */
+import { z } from 'zod';
+import { JiraClient } from '../client.js';
+/**
+ * Schema for get_transitions tool input.
+ */
+export declare const getTransitionsSchema: z.ZodObject<{
+    issueKey: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    issueKey: string;
+}, {
+    issueKey: string;
+}>;
+/**
+ * Schema for transition_issue tool input.
+ */
+export declare const transitionIssueSchema: z.ZodObject<{
+    issueKey: z.ZodString;
+    transitionId: z.ZodString;
+    comment: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    issueKey: string;
+    transitionId: string;
+    comment?: string | undefined;
+}, {
+    issueKey: string;
+    transitionId: string;
+    comment?: string | undefined;
+}>;
+/**
+ * Creates transition tool handlers.
+ * @param client - Jira client instance
+ * @returns Object containing transition tool handlers
+ */
+export declare function createTransitionTools(client: JiraClient): {
+    /**
+     * Gets available transitions for an issue.
+     */
+    jira_get_transitions: (args: z.infer<typeof getTransitionsSchema>) => Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+    /**
+     * Transitions an issue to a new status.
+     */
+    jira_transition_issue: (args: z.infer<typeof transitionIssueSchema>) => Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+};
+/**
+ * Tool definitions for transition operations.
+ * Semantic descriptions help AI understand workflow operations.
+ */
+export declare const transitionToolDefinitions: ({
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            issueKey: {
+                type: string;
+                description: string;
+            };
+            transitionId?: undefined;
+            comment?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            issueKey: {
+                type: string;
+                description: string;
+            };
+            transitionId: {
+                type: string;
+                description: string;
+            };
+            comment: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+})[];
+//# sourceMappingURL=transitions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"transitions.d.ts","sourceRoot":"","sources":["../../src/tools/transitions.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,oBAAoB;;;;;;EAE/B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;EAIhC,CAAC;AAEH;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,UAAU;IAEhD;;OAEG;iCACgC,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC;;;;;;IAwBvE;;OAEG;kCACiC,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC;;;;;;EAmBhF;AAED;;;GAGG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAgDrC,CAAC"}

package/dist/tools/transitions.js

@@ -0,0 +1,121 @@
+/**
+ * @file tools/transitions.ts
+ * @description Workflow transition tools for Jira MCP.
+ */
+import { z } from 'zod';
+/**
+ * Schema for get_transitions tool input.
+ */
+export const getTransitionsSchema = z.object({
+    issueKey: z.string().describe('The issue key or ID'),
+});
+/**
+ * Schema for transition_issue tool input.
+ */
+export const transitionIssueSchema = z.object({
+    issueKey: z.string().describe('The issue key or ID'),
+    transitionId: z.string().describe('The ID of the transition to execute'),
+    comment: z.string().optional().describe('Optional comment to add during transition'),
+});
+/**
+ * Creates transition tool handlers.
+ * @param client - Jira client instance
+ * @returns Object containing transition tool handlers
+ */
+export function createTransitionTools(client) {
+    return {
+        /**
+         * Gets available transitions for an issue.
+         */
+        jira_get_transitions: async (args) => {
+            const result = await client.getTransitions(args.issueKey);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            issueKey: args.issueKey,
+                            transitions: result.transitions.map((t) => ({
+                                id: t.id,
+                                name: t.name,
+                                toStatus: t.to.name,
+                                toStatusCategory: t.to.statusCategory.name,
+                            })),
+                        }, null, 2),
+                    },
+                ],
+            };
+        },
+        /**
+         * Transitions an issue to a new status.
+         */
+        jira_transition_issue: async (args) => {
+            await client.transitionIssue(args.issueKey, args.transitionId, args.comment);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            success: true,
+                            message: `Issue ${args.issueKey} transitioned successfully`,
+                        }, null, 2),
+                    },
+                ],
+            };
+        },
+    };
+}
+/**
+ * Tool definitions for transition operations.
+ * Semantic descriptions help AI understand workflow operations.
+ */
+export const transitionToolDefinitions = [
+    {
+        name: 'jira_get_transitions',
+        description: `Get available workflow transitions for an issue. Use FIRST when user wants to:
+- Move an issue to a different status
+- Start, complete, close, or reopen a ticket
+- Change workflow state
+
+Returns list of valid transitions with IDs. Required before calling jira_transition_issue.`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                issueKey: {
+                    type: 'string',
+                    description: 'Issue key like PROJ-123',
+                },
+            },
+            required: ['issueKey'],
+        },
+    },
+    {
+        name: 'jira_transition_issue',
+        description: `Move a Jira issue to a new workflow status. Use when user wants to:
+- Start working on a ticket (→ In Progress)
+- Complete or close an issue (→ Done)
+- Reopen a closed issue
+- Change issue status
+
+IMPORTANT: Call jira_get_transitions first to get valid transition IDs.`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                issueKey: {
+                    type: 'string',
+                    description: 'Issue key to transition',
+                },
+                transitionId: {
+                    type: 'string',
+                    description: 'Transition ID from jira_get_transitions',
+                },
+                comment: {
+                    type: 'string',
+                    description: 'Optional comment to add with transition',
+                },
+            },
+            required: ['issueKey', 'transitionId'],
+        },
+    },
+];
+//# sourceMappingURL=transitions.js.map

package/dist/tools/transitions.js.map

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

package/dist/tools/users.d.ts

@@ -0,0 +1,70 @@
+/**
+ * @file tools/users.ts
+ * @description User-related MCP tools for Jira.
+ */
+import { z } from 'zod';
+import { JiraClient } from '../client.js';
+/**
+ * Schema for get_user tool input.
+ */
+export declare const getUserSchema: z.ZodObject<{
+    username: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    username: string;
+}, {
+    username: string;
+}>;
+/**
+ * Creates user tool handlers.
+ * @param client - Jira client instance
+ * @returns Object containing user tool handlers
+ */
+export declare function createUserTools(client: JiraClient): {
+    /**
+     * Gets the currently authenticated user.
+     */
+    jira_get_current_user: () => Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+    /**
+     * Gets a user by username.
+     */
+    jira_get_user: (args: z.infer<typeof getUserSchema>) => Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+};
+/**
+ * Tool definitions for user operations.
+ * Semantic descriptions help AI understand user lookups.
+ */
+export declare const userToolDefinitions: ({
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            username?: undefined;
+        };
+        required: never[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            username: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+})[];
+//# sourceMappingURL=users.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"users.d.ts","sourceRoot":"","sources":["../../src/tools/users.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,aAAa;;;;;;EAExB,CAAC;AAEH;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,UAAU;IAE1C;;OAEG;;;;;;;IAuBH;;OAEG;0BACyB,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC;;;;;;EAsBhE;AAED;;;GAGG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;IA8B/B,CAAC"}

package/dist/tools/users.js

@@ -0,0 +1,96 @@
+/**
+ * @file tools/users.ts
+ * @description User-related MCP tools for Jira.
+ */
+import { z } from 'zod';
+/**
+ * Schema for get_user tool input.
+ */
+export const getUserSchema = z.object({
+    username: z.string().describe('The username to look up'),
+});
+/**
+ * Creates user tool handlers.
+ * @param client - Jira client instance
+ * @returns Object containing user tool handlers
+ */
+export function createUserTools(client) {
+    return {
+        /**
+         * Gets the currently authenticated user.
+         */
+        jira_get_current_user: async () => {
+            const user = await client.getCurrentUser();
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            name: user.name,
+                            displayName: user.displayName,
+                            emailAddress: user.emailAddress,
+                            active: user.active,
+                            timeZone: user.timeZone,
+                        }, null, 2),
+                    },
+                ],
+            };
+        },
+        /**
+         * Gets a user by username.
+         */
+        jira_get_user: async (args) => {
+            const user = await client.getUser(args.username);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            name: user.name,
+                            displayName: user.displayName,
+                            emailAddress: user.emailAddress,
+                            active: user.active,
+                            timeZone: user.timeZone,
+                        }, null, 2),
+                    },
+                ],
+            };
+        },
+    };
+}
+/**
+ * Tool definitions for user operations.
+ * Semantic descriptions help AI understand user lookups.
+ */
+export const userToolDefinitions = [
+    {
+        name: 'jira_get_current_user',
+        description: `Get the currently logged-in Jira user's info. Use when user asks:
+- "Who am I logged in as?"
+- "What's my Jira username?"
+- Need to know the current user for searches like "my issues"`,
+        inputSchema: {
+            type: 'object',
+            properties: {},
+            required: [],
+        },
+    },
+    {
+        name: 'jira_get_user',
+        description: `Look up a Jira user by username. Use when user wants to:
+- Find info about a specific team member
+- Check if a username exists
+- Get a user's display name or email`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                username: {
+                    type: 'string',
+                    description: 'Jira username to look up',
+                },
+            },
+            required: ['username'],
+        },
+    },
+];
+//# sourceMappingURL=users.js.map

package/dist/tools/users.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"users.js","sourceRoot":"","sources":["../../src/tools/users.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,yBAAyB,CAAC;CAC3D,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,MAAkB;IAC9C,OAAO;QACH;;WAEG;QACH,qBAAqB,EAAE,KAAK,IAAI,EAAE;YAC9B,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,cAAc,EAAE,CAAC;YAC3C,OAAO;gBACH,OAAO,EAAE;oBACL;wBACI,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAChB;4BACI,IAAI,EAAE,IAAI,CAAC,IAAI;4BACf,WAAW,EAAE,IAAI,CAAC,WAAW;4BAC7B,YAAY,EAAE,IAAI,CAAC,YAAY;4BAC/B,MAAM,EAAE,IAAI,CAAC,MAAM;4BACnB,QAAQ,EAAE,IAAI,CAAC,QAAQ;yBAC1B,EACD,IAAI,EACJ,CAAC,CACJ;qBACJ;iBACJ;aACJ,CAAC;QACN,CAAC;QAED;;WAEG;QACH,aAAa,EAAE,KAAK,EAAE,IAAmC,EAAE,EAAE;YACzD,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACjD,OAAO;gBACH,OAAO,EAAE;oBACL;wBACI,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAChB;4BACI,IAAI,EAAE,IAAI,CAAC,IAAI;4BACf,WAAW,EAAE,IAAI,CAAC,WAAW;4BAC7B,YAAY,EAAE,IAAI,CAAC,YAAY;4BAC/B,MAAM,EAAE,IAAI,CAAC,MAAM;4BACnB,QAAQ,EAAE,IAAI,CAAC,QAAQ;yBAC1B,EACD,IAAI,EACJ,CAAC,CACJ;qBACJ;iBACJ;aACJ,CAAC;QACN,CAAC;KACJ,CAAC;AACN,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;IAC/B;QACI,IAAI,EAAE,uBAAuB;QAC7B,WAAW,EAAE;;;8DAGyC;QACtD,WAAW,EAAE;YACT,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE,EAAE;YACd,QAAQ,EAAE,EAAE;SACf;KACJ;IACD;QACI,IAAI,EAAE,eAAe;QACrB,WAAW,EAAE;;;qCAGgB;QAC7B,WAAW,EAAE;YACT,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE;gBACR,QAAQ,EAAE;oBACN,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,0BAA0B;iBAC1C;aACJ;YACD,QAAQ,EAAE,CAAC,UAAU,CAAC;SACzB;KACJ;CACJ,CAAC"}

package/dist/types/mcp-config.d.ts

@@ -0,0 +1,154 @@
+/**
+ * @file mcp-config.ts
+ * @description Type definitions for dynamic MCP configuration system.
+ * Defines schemas for remote config fetcher and MCP client registry.
+ */
+/**
+ * Platform-specific config file locations.
+ * Maps platform (macos/windows/linux in remote config) to available config paths.
+ * Note: Remote JSON uses macos/windows/linux, not darwin/win32/linux.
+ */
+export interface ConfigLocations {
+    macos?: PlatformPaths;
+    windows?: PlatformPaths;
+    linux?: PlatformPaths;
+}
+/**
+ * Path configuration for a specific platform.
+ */
+export interface PlatformPaths {
+    global?: string;
+    user?: string;
+    project?: string;
+    workspace?: string;
+    local?: string;
+    managed?: string;
+    globalAlt?: string;
+}
+/**
+ * Wrapper key types used by different MCP clients.
+ * Identifies the top-level key containing MCP server configs.
+ */
+export type WrapperKey = 'mcpServers' | 'mcp' | 'servers' | 'context_servers' | 'mcp_servers';
+/**
+ * Configuration scopes supported by MCP clients.
+ */
+export type ConfigScope = 'global' | 'user' | 'project' | 'workspace' | 'local' | 'managed';
+/**
+ * Transport types supported by MCP clients.
+ */
+export type TransportType = 'stdio' | 'http' | 'sse' | 'local' | 'remote';
+/**
+ * Server schema definition for MCP config.
+ * Describes required/optional fields for server configuration.
+ */
+export interface ServerSchema {
+    type?: string;
+    command?: SchemaField;
+    args?: SchemaField;
+    url?: SchemaField;
+    headers?: SchemaField;
+    env?: SchemaField;
+    environment?: SchemaField;
+}
+/**
+ * Schema field definition.
+ */
+export interface SchemaField {
+    type: string;
+    required?: boolean;
+    description?: string;
+    enum?: string[];
+    default?: string;
+    items?: string;
+}
+/**
+ * Configuration format details for an MCP client.
+ */
+export interface ConfigFormat {
+    wrapperKey: WrapperKey;
+    serverSchema: ServerSchema;
+    example?: Record<string, unknown>;
+    format?: string;
+    yamlAlternative?: {
+        path: string;
+        note: string;
+        example: string;
+    };
+}
+/**
+ * CLI commands for managing MCP servers.
+ */
+export interface CliCommands {
+    add?: string;
+    addJson?: string;
+    list?: string;
+    get?: string;
+    remove?: string;
+    enable?: string;
+    disable?: string;
+    edit?: string;
+    show?: string;
+    importDesktop?: string;
+}
+/**
+ * MCP client configuration from remote JSON.
+ */
+export interface McpClientConfig {
+    name: string;
+    vendor?: string;
+    description?: string;
+    docsUrl?: string;
+    configLocations: ConfigLocations;
+    managedConfig?: Record<string, string>;
+    configFormat: ConfigFormat;
+    cli?: CliCommands;
+    scopes: ConfigScope[];
+    transportSupport: TransportType[];
+    notes?: string[];
+    ui?: {
+        access?: string;
+        install?: string;
+        manage?: string;
+    };
+}
+/**
+ * Remote MCP configuration schema.
+ * Top-level structure fetched from GitHub.
+ */
+export interface McpConfigSchema {
+    $schema?: string;
+    $id?: string;
+    version: string;
+    lastUpdated: string;
+    description?: string;
+    clients: Record<string, McpClientConfig>;
+    commonPatterns?: {
+        stdioServer?: Record<string, unknown>;
+        httpServer?: Record<string, unknown>;
+    };
+    wrapperKeyMapping?: Record<WrapperKey, string[]>;
+    envVariableExpansion?: Record<string, unknown>;
+}
+/**
+ * Options for fetching MCP configuration.
+ */
+export interface FetchOptions {
+    forceRefresh?: boolean;
+    timeout?: number;
+    retries?: number;
+}
+/**
+ * Cache entry for in-memory caching.
+ */
+export interface CacheEntry {
+    data: McpConfigSchema;
+    etag?: string;
+    fetchedAt: number;
+    ttl: number;
+}
+/**
+ * Config file type (JSON, YAML, TOML).
+ */
+export type ConfigFileType = 'json' | 'yaml' | 'toml';
+//# sourceMappingURL=mcp-config.d.ts.map

package/dist/types/mcp-config.d.ts.map

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