@khanglvm/jira-mcp 1.3.0

package/dist/setup.js

@@ -0,0 +1,263 @@
+/**
+ * @file setup.ts
+ * @description CLI setup command for injecting MCP configuration into various AI tools.
+ * Dynamically supports all MCP clients from the registry (14 tools).
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { createRegistry } from './mcp-registry.js';
+import { mapPlatform, resolvePlatformPath } from './utils/path-resolver.js';
+/** Registry cache for avoiding repeated fetches */
+let registryCache = null;
+/**
+ * Initializes the MCP registry (cached).
+ * @returns Initialized MCP registry
+ */
+async function initializeRegistry() {
+    if (!registryCache) {
+        registryCache = await createRegistry();
+    }
+    return registryCache;
+}
+/**
+ * Expands environment variables and home directory in a path.
+ */
+function expandPath(filePath) {
+    return path.resolve(resolvePlatformPath(filePath));
+}
+/**
+ * Gets the config file path and format for each CLI tool using the MCP registry.
+ * @param cli - Target CLI tool
+ * @param scope - User or project scope
+ * @returns Config file info or null if unsupported
+ */
+async function getConfigFileInfo(cli, scope) {
+    const registry = await initializeRegistry();
+    const client = registry.getClient(cli);
+    if (!client) {
+        return null;
+    }
+    // Check if client supports the requested scope
+    if (!registry.supportsScope(cli, scope)) {
+        return null;
+    }
+    // Map Node.js platform to registry platform key
+    const platformKey = mapPlatform(process.platform);
+    const platformLocations = client.configLocations[platformKey];
+    if (!platformLocations) {
+        return null;
+    }
+    // Get path for the requested scope
+    // PlatformPaths has: global?, user?, project?, workspace?, local?, managed?, globalAlt?
+    const scopePath = platformLocations[scope];
+    if (!scopePath || typeof scopePath !== 'string') {
+        return null;
+    }
+    // Expand environment variables and home directory
+    const expandedPath = expandPath(scopePath);
+    return {
+        path: expandedPath,
+        wrapperKey: client.configFormat.wrapperKey,
+        serverKey: 'jira',
+    };
+}
+/**
+ * Creates the MCP server configuration for Jira.
+ * @param options - Setup options with credentials
+ * @returns MCP server config object
+ */
+function createJiraServerConfig(options) {
+    return {
+        command: 'npx',
+        args: ['-y', '@khanglvm/jira-mcp'],
+        env: {
+            JIRA_BASE_URL: options.baseUrl,
+            JIRA_USERNAME: options.username,
+            JIRA_PASSWORD: options.password,
+        },
+    };
+}
+/**
+ * Reads existing config file or returns empty object.
+ * @param filePath - Path to config file
+ * @returns Parsed JSON object
+ */
+function readConfigFile(filePath) {
+    try {
+        if (fs.existsSync(filePath)) {
+            const content = fs.readFileSync(filePath, 'utf-8');
+            return JSON.parse(content);
+        }
+    }
+    catch (error) {
+        console.warn(`Warning: Could not read existing config at ${filePath}`);
+    }
+    return {};
+}
+/**
+ * Ensures parent directories exist.
+ * @param filePath - File path to ensure directories for
+ */
+function ensureDirectoryExists(filePath) {
+    const dir = path.dirname(filePath);
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+}
+/**
+ * Injects MCP configuration into the target CLI tool's config file.
+ * @param options - Setup options
+ * @returns Result message
+ */
+export async function injectMcpConfig(options) {
+    const configInfo = await getConfigFileInfo(options.cli, options.scope);
+    if (!configInfo) {
+        return {
+            success: false,
+            message: `Error: ${options.cli} does not support ${options.scope} scope configuration.`,
+        };
+    }
+    try {
+        // Read existing config
+        const config = readConfigFile(configInfo.path);
+        // Get or create the wrapper object (mcpServers, servers, etc.)
+        const wrapperKey = configInfo.wrapperKey;
+        if (!config[wrapperKey]) {
+            config[wrapperKey] = {};
+        }
+        const wrapper = config[wrapperKey];
+        // Check if jira config already exists
+        if (wrapper[configInfo.serverKey]) {
+            console.log(`ℹ️  Existing Jira MCP configuration found. Updating...`);
+        }
+        // Add/update Jira server config
+        wrapper[configInfo.serverKey] = createJiraServerConfig(options);
+        // Ensure directory exists and write file
+        ensureDirectoryExists(configInfo.path);
+        fs.writeFileSync(configInfo.path, JSON.stringify(config, null, 2) + '\n', 'utf-8');
+        return {
+            success: true,
+            message: `✅ Successfully configured Jira MCP for ${options.cli} (${options.scope} scope)\n   Config file: ${configInfo.path}`,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            message: `Error writing config: ${error.message}`,
+        };
+    }
+}
+/**
+ * Parses CLI arguments for setup command.
+ * @param args - Command line arguments
+ * @returns Parsed options or null if invalid
+ */
+export function parseSetupArgs(args) {
+    const options = {
+        scope: 'user', // Default scope
+    };
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        const nextArg = args[i + 1];
+        switch (arg) {
+            case '-c':
+            case '--cli':
+                options.cli = nextArg;
+                i++;
+                break;
+            case '-b':
+            case '--base-url':
+            case '--url':
+                options.baseUrl = nextArg;
+                i++;
+                break;
+            case '-u':
+            case '--username':
+                options.username = nextArg;
+                i++;
+                break;
+            case '-p':
+            case '--password':
+                options.password = nextArg;
+                i++;
+                break;
+            case '-s':
+            case '--scope':
+                options.scope = nextArg;
+                i++;
+                break;
+        }
+    }
+    // Validate required fields
+    const validClis = [
+        'claude-code', 'claude-desktop', 'github-copilot', 'cursor',
+        'windsurf', 'roo-code', 'zed', 'factory-droid', 'antigravity', 'gemini-cli',
+        'opencode', 'vscode-copilot', 'jetbrains-copilot', 'codex-cli'
+    ];
+    if (!options.cli || !validClis.includes(options.cli)) {
+        return null;
+    }
+    if (!options.baseUrl || !options.username || !options.password) {
+        return null;
+    }
+    if (options.scope && !['user', 'project'].includes(options.scope)) {
+        return null;
+    }
+    return options;
+}
+/**
+ * Prints setup help message.
+ */
+export function printSetupHelp() {
+    console.log(`
+Jira MCP Setup - Inject configuration into AI tool config files
+
+Usage:
+  npx @khanglvm/jira-mcp setup -c <cli> -b <url> -u <user> -p <pass> [-s <scope>]
+
+Arguments:
+  -c, --cli        Target CLI tool (required)
+                   Options: claude-code, claude-desktop, github-copilot, cursor,
+                            windsurf, roo-code, zed, factory-droid, antigravity,
+                            gemini-cli, opencode, vscode-copilot, jetbrains-copilot,
+                            codex-cli
+
+  -b, --base-url   Jira base URL (required)
+  -u, --username   Jira username (required)
+  -p, --password   Jira password (required)
+  -s, --scope      Configuration scope (optional, default: user)
+                   Options: user, project
+
+Examples:
+  npx @khanglvm/jira-mcp setup -c claude-code -b https://jira.example.com -u admin -p secret
+  npx @khanglvm/jira-mcp setup -c cursor -b https://jira.example.com -u admin -p secret -s project
+
+Supported CLI Tools:
+  claude-code, claude-desktop, github-copilot, cursor, windsurf, roo-code, zed,
+  factory-droid, antigravity, gemini-cli, opencode, vscode-copilot, jetbrains-copilot,
+  codex-cli
+`);
+}
+/**
+ * Lists all supported CLI tools.
+ */
+export function printSupportedClis() {
+    console.log(`
+Supported CLI tools (14):
+  • claude-code         - Claude Code (Anthropic)
+  • claude-desktop      - Claude Desktop App
+  • github-copilot      - GitHub Copilot (VS Code)
+  • cursor              - Cursor AI Editor
+  • windsurf            - Windsurf (Codeium)
+  • roo-code            - Roo Code
+  • zed                 - Zed Editor
+  • factory-droid       - Factory Droid AI
+  • antigravity         - Google Antigravity IDE
+  • gemini-cli          - Gemini CLI (Google)
+  • opencode            - OpenCode Editor
+  • vscode-copilot      - VS Code Copilot Extension
+  • jetbrains-copilot   - JetBrains IDEs
+  • codex-cli           - Codex CLI
+`);
+}
+//# sourceMappingURL=setup.js.map

package/dist/setup.js.map

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

package/dist/tools/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @file tools/index.ts
+ * @description Aggregates all tool exports for the Jira MCP server.
+ */
+export * from './issues.js';
+export * from './search.js';
+export * from './projects.js';
+export * from './transitions.js';
+export * from './users.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC"}

package/dist/tools/index.js

@@ -0,0 +1,10 @@
+/**
+ * @file tools/index.ts
+ * @description Aggregates all tool exports for the Jira MCP server.
+ */
+export * from './issues.js';
+export * from './search.js';
+export * from './projects.js';
+export * from './transitions.js';
+export * from './users.js';
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC"}

package/dist/tools/issues.d.ts

@@ -0,0 +1,364 @@
+/**
+ * @file tools/issues.ts
+ * @description Issue-related MCP tools for Jira.
+ * Provides tools for creating, reading, updating, and deleting issues.
+ */
+import { z } from 'zod';
+import { JiraClient } from '../client.js';
+/**
+ * Schema for get_issue tool input.
+ */
+export declare const getIssueSchema: z.ZodObject<{
+    issueKey: z.ZodString;
+    fields: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    issueKey: string;
+    fields?: string | undefined;
+}, {
+    issueKey: string;
+    fields?: string | undefined;
+}>;
+/**
+ * Schema for create_issue tool input.
+ */
+export declare const createIssueSchema: z.ZodObject<{
+    projectKey: z.ZodString;
+    summary: z.ZodString;
+    issueType: z.ZodDefault<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    assignee: z.ZodOptional<z.ZodString>;
+    priority: z.ZodOptional<z.ZodString>;
+    labels: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    summary: string;
+    projectKey: string;
+    issueType: string;
+    assignee?: string | undefined;
+    priority?: string | undefined;
+    description?: string | undefined;
+    labels?: string[] | undefined;
+}, {
+    summary: string;
+    projectKey: string;
+    assignee?: string | undefined;
+    priority?: string | undefined;
+    description?: string | undefined;
+    labels?: string[] | undefined;
+    issueType?: string | undefined;
+}>;
+/**
+ * Schema for update_issue tool input.
+ */
+export declare const updateIssueSchema: z.ZodObject<{
+    issueKey: z.ZodString;
+    summary: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    assignee: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    priority: z.ZodOptional<z.ZodString>;
+    labels: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    issueKey: string;
+    summary?: string | undefined;
+    assignee?: string | null | undefined;
+    priority?: string | undefined;
+    description?: string | undefined;
+    labels?: string[] | undefined;
+}, {
+    issueKey: string;
+    summary?: string | undefined;
+    assignee?: string | null | undefined;
+    priority?: string | undefined;
+    description?: string | undefined;
+    labels?: string[] | undefined;
+}>;
+/**
+ * Schema for delete_issue tool input.
+ */
+export declare const deleteIssueSchema: z.ZodObject<{
+    issueKey: z.ZodString;
+    deleteSubtasks: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    issueKey: string;
+    deleteSubtasks: boolean;
+}, {
+    issueKey: string;
+    deleteSubtasks?: boolean | undefined;
+}>;
+/**
+ * Schema for add_comment tool input.
+ */
+export declare const addCommentSchema: z.ZodObject<{
+    issueKey: z.ZodString;
+    body: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    issueKey: string;
+    body: string;
+}, {
+    issueKey: string;
+    body: string;
+}>;
+/**
+ * Schema for get_comments tool input.
+ */
+export declare const getCommentsSchema: z.ZodObject<{
+    issueKey: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    issueKey: string;
+}, {
+    issueKey: string;
+}>;
+/**
+ * Creates issue tool handlers.
+ * @param client - Jira client instance
+ * @returns Object containing all issue tool handlers
+ */
+export declare function createIssueTools(client: JiraClient): {
+    /**
+     * Gets an issue by key or ID.
+     */
+    jira_get_issue: (args: z.infer<typeof getIssueSchema>) => Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+    /**
+     * Creates a new issue.
+     */
+    jira_create_issue: (args: z.infer<typeof createIssueSchema>) => Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+    /**
+     * Updates an existing issue.
+     */
+    jira_update_issue: (args: z.infer<typeof updateIssueSchema>) => Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+    /**
+     * Deletes an issue.
+     */
+    jira_delete_issue: (args: z.infer<typeof deleteIssueSchema>) => Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+    /**
+     * Adds a comment to an issue.
+     */
+    jira_add_comment: (args: z.infer<typeof addCommentSchema>) => Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+    /**
+     * Gets comments on an issue.
+     */
+    jira_get_comments: (args: z.infer<typeof getCommentsSchema>) => Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+};
+/**
+ * Tool definitions for issue-related operations.
+ * Semantic descriptions help AI understand when to use each tool.
+ */
+export declare const issueToolDefinitions: ({
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            issueKey: {
+                type: string;
+                description: string;
+            };
+            fields: {
+                type: string;
+                description: string;
+            };
+            projectKey?: undefined;
+            summary?: undefined;
+            issueType?: undefined;
+            description?: undefined;
+            assignee?: undefined;
+            priority?: undefined;
+            labels?: undefined;
+            deleteSubtasks?: undefined;
+            body?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            projectKey: {
+                type: string;
+                description: string;
+            };
+            summary: {
+                type: string;
+                description: string;
+            };
+            issueType: {
+                type: string;
+                description: string;
+                default: string;
+            };
+            description: {
+                type: string;
+                description: string;
+            };
+            assignee: {
+                type: string;
+                description: string;
+            };
+            priority: {
+                type: string;
+                description: string;
+            };
+            labels: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+            issueKey?: undefined;
+            fields?: undefined;
+            deleteSubtasks?: undefined;
+            body?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            issueKey: {
+                type: string;
+                description: string;
+            };
+            summary: {
+                type: string;
+                description: string;
+            };
+            description: {
+                type: string;
+                description: string;
+            };
+            assignee: {
+                type: string[];
+                description: string;
+            };
+            priority: {
+                type: string;
+                description: string;
+            };
+            labels: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+            fields?: undefined;
+            projectKey?: undefined;
+            issueType?: undefined;
+            deleteSubtasks?: undefined;
+            body?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            issueKey: {
+                type: string;
+                description: string;
+            };
+            deleteSubtasks: {
+                type: string;
+                description: string;
+                default: boolean;
+            };
+            fields?: undefined;
+            projectKey?: undefined;
+            summary?: undefined;
+            issueType?: undefined;
+            description?: undefined;
+            assignee?: undefined;
+            priority?: undefined;
+            labels?: undefined;
+            body?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            issueKey: {
+                type: string;
+                description: string;
+            };
+            body: {
+                type: string;
+                description: string;
+            };
+            fields?: undefined;
+            projectKey?: undefined;
+            summary?: undefined;
+            issueType?: undefined;
+            description?: undefined;
+            assignee?: undefined;
+            priority?: undefined;
+            labels?: undefined;
+            deleteSubtasks?: undefined;
+        };
+        required: string[];
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            issueKey: {
+                type: string;
+                description: string;
+            };
+            fields?: undefined;
+            projectKey?: undefined;
+            summary?: undefined;
+            issueType?: undefined;
+            description?: undefined;
+            assignee?: undefined;
+            priority?: undefined;
+            labels?: undefined;
+            deleteSubtasks?: undefined;
+            body?: undefined;
+        };
+        required: string[];
+    };
+})[];
+//# sourceMappingURL=issues.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"issues.d.ts","sourceRoot":"","sources":["../../src/tools/issues.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;;;;;EAMzB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;EAW5B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;EAW5B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;EAM5B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;EAG3B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;EAE5B,CAAC;AAEH;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU;IAE3C;;OAEG;2BAC0B,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC;;;;;;IA8B3D;;OAEG;8BAC6B,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC;;;;;;IA6BjE;;OAEG;8BAC6B,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC;;;;;;IAyBjE;;OAEG;8BAC6B,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC;;;;;;IAmBjE;;OAEG;6BAC4B,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC;;;;;;IAqB/D;;OAEG;8BAC6B,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC;;;;;;EAyBxE;AAED;;;GAGG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IA2KhC,CAAC"}