@lvmk/jira-mcp 1.0.0

package/dist/index.js

@@ -0,0 +1,222 @@
+#!/usr/bin/env node
+/**
+ * @file index.ts
+ * @description Main entry point for the Jira MCP server.
+ * Supports two modes:
+ * 1. MCP Server mode (default) - Runs as stdio MCP server for AI tools
+ * 2. Setup mode - Injects MCP configuration into AI tool config files
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { loadConfig } from './config.js';
+import { JiraClient, JiraApiError } from './client.js';
+import { createIssueTools, issueToolDefinitions, createSearchTools, searchToolDefinitions, createProjectTools, projectToolDefinitions, createTransitionTools, transitionToolDefinitions, createUserTools, userToolDefinitions, } from './tools/index.js';
+import { parseSetupArgs, injectMcpConfig, printSetupHelp, printSupportedClis, } from './setup.js';
+/**
+ * Package information for server identification.
+ */
+const SERVER_INFO = {
+    name: '@lvmk/jira-mcp',
+    version: '1.0.0',
+};
+/**
+ * Prints general help message.
+ */
+function printHelp() {
+    console.log(`
+@lvmk/jira-mcp - Jira MCP Server for Legacy Jira Server (Basic Auth)
+
+MODES:
+
+  1. MCP Server Mode (default)
+     Run as an MCP server for AI tools to connect to.
+     
+     Required Environment Variables:
+       JIRA_BASE_URL  - Jira server URL (e.g., https://jira.example.com)
+       JIRA_USERNAME  - Username for basic auth
+       JIRA_PASSWORD  - Password for basic auth
+
+     Usage:
+       npx @lvmk/jira-mcp
+
+  2. Setup Mode
+     Inject MCP configuration into AI tool config files.
+
+     Usage:
+       npx @lvmk/jira-mcp setup -c <cli> -b <url> -u <user> -p <pass> [-s <scope>]
+
+     Run 'npx @lvmk/jira-mcp setup --help' for more details.
+
+COMMANDS:
+  setup       Configure MCP in AI tool config files
+  list-clis   List supported AI CLI tools
+  --help      Show this help message
+  --version   Show version
+
+EXAMPLES:
+  # Run as MCP server
+  JIRA_BASE_URL=https://jira.example.com JIRA_USERNAME=admin JIRA_PASSWORD=secret npx @lvmk/jira-mcp
+
+  # Setup for Claude Code
+  npx @lvmk/jira-mcp setup -c claude-code -b https://jira.example.com -u admin -p secret
+
+  # Setup for Cursor (project scope)
+  npx @lvmk/jira-mcp setup -c cursor -b https://jira.example.com -u admin -p secret -s project
+`);
+}
+/**
+ * Handles CLI commands and arguments.
+ * @returns true if handled as CLI command, false to continue as MCP server
+ */
+function handleCliCommands() {
+    const args = process.argv.slice(2);
+    if (args.length === 0) {
+        return false; // No args, run as MCP server
+    }
+    const command = args[0];
+    switch (command) {
+        case '--help':
+        case '-h':
+        case 'help':
+            printHelp();
+            return true;
+        case '--version':
+        case '-v':
+            console.log(SERVER_INFO.version);
+            return true;
+        case 'list-clis':
+            printSupportedClis();
+            return true;
+        case 'setup': {
+            const setupArgs = args.slice(1);
+            if (setupArgs.length === 0 || setupArgs.includes('--help') || setupArgs.includes('-h')) {
+                printSetupHelp();
+                return true;
+            }
+            const options = parseSetupArgs(setupArgs);
+            if (!options) {
+                console.error('Error: Invalid arguments. Run with --help for usage.\n');
+                printSetupHelp();
+                process.exit(1);
+            }
+            const result = injectMcpConfig(options);
+            console.log(result.message);
+            if (!result.success) {
+                process.exit(1);
+            }
+            return true;
+        }
+        default:
+            // Unknown command, check if it looks like MCP server mode
+            if (command.startsWith('-')) {
+                console.error(`Unknown option: ${command}`);
+                printHelp();
+                process.exit(1);
+            }
+            return false;
+    }
+}
+/**
+ * Main function to initialize and run the MCP server.
+ */
+async function runMcpServer() {
+    // Load and validate configuration from environment
+    let config;
+    try {
+        config = loadConfig();
+    }
+    catch (error) {
+        console.error(error.message);
+        process.exit(1);
+    }
+    // Initialize Jira client
+    const jiraClient = new JiraClient(config);
+    // Create tool handlers
+    const issueTools = createIssueTools(jiraClient);
+    const searchTools = createSearchTools(jiraClient);
+    const projectTools = createProjectTools(jiraClient);
+    const transitionTools = createTransitionTools(jiraClient);
+    const userTools = createUserTools(jiraClient);
+    // Combine all tool handlers with type assertion 
+    // Individual handlers have stricter param types, but we know the SDK will provide correct args
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const allToolHandlers = {
+        ...issueTools,
+        ...searchTools,
+        ...projectTools,
+        ...transitionTools,
+        ...userTools,
+    };
+    // Combine all tool definitions
+    const allToolDefinitions = [
+        ...issueToolDefinitions,
+        ...searchToolDefinitions,
+        ...projectToolDefinitions,
+        ...transitionToolDefinitions,
+        ...userToolDefinitions,
+    ];
+    // Create MCP server
+    const server = new Server(SERVER_INFO, {
+        capabilities: {
+            tools: {},
+        },
+    });
+    // Register list_tools handler
+    server.setRequestHandler(ListToolsRequestSchema, async () => {
+        return {
+            tools: allToolDefinitions,
+        };
+    });
+    // Register call_tool handler
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const { name, arguments: args } = request.params;
+        const handler = allToolHandlers[name];
+        if (!handler) {
+            throw new Error(`Unknown tool: ${name}`);
+        }
+        try {
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            return await handler(args);
+        }
+        catch (error) {
+            // Handle Jira API errors gracefully
+            if (error instanceof JiraApiError) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify({
+                                error: true,
+                                message: error.message,
+                                statusCode: error.statusCode,
+                                details: error.body,
+                            }, null, 2),
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            // Re-throw unexpected errors
+            throw error;
+        }
+    });
+    // Create stdio transport and connect
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    // Log successful startup to stderr (not stdout, to avoid interfering with MCP protocol)
+    console.error(`Jira MCP server started - connected to ${config.JIRA_BASE_URL}`);
+}
+// Main entry point
+if (handleCliCommands()) {
+    // CLI command handled, exit normally
+    process.exit(0);
+}
+else {
+    // Run as MCP server
+    runMcpServer().catch((error) => {
+        console.error('Fatal error:', error);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/setup.d.ts

@@ -0,0 +1,41 @@
+/**
+ * @file setup.ts
+ * @description CLI setup command for injecting MCP configuration into various AI tools.
+ * Supports: Claude Code, Claude Desktop, GitHub Copilot, Cursor, Windsurf, Roo Code, Zed, Factory Droid
+ */
+/** Supported CLI tools for MCP configuration */
+export type SupportedCli = 'claude-code' | 'claude-desktop' | 'copilot' | 'cursor' | 'windsurf' | 'roo-code' | 'zed' | 'factory-droid';
+/** Configuration scope - user-level or project-level */
+export type ConfigScope = 'user' | 'project';
+/** Setup options from CLI arguments */
+export interface SetupOptions {
+    cli: SupportedCli;
+    baseUrl: string;
+    username: string;
+    password: string;
+    scope: ConfigScope;
+}
+/**
+ * Injects MCP configuration into the target CLI tool's config file.
+ * @param options - Setup options
+ * @returns Result message
+ */
+export declare function injectMcpConfig(options: SetupOptions): {
+    success: boolean;
+    message: string;
+};
+/**
+ * Parses CLI arguments for setup command.
+ * @param args - Command line arguments
+ * @returns Parsed options or null if invalid
+ */
+export declare function parseSetupArgs(args: string[]): SetupOptions | null;
+/**
+ * Prints setup help message.
+ */
+export declare function printSetupHelp(): void;
+/**
+ * Lists all supported CLI tools.
+ */
+export declare function printSupportedClis(): void;
+//# sourceMappingURL=setup.d.ts.map

package/dist/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../src/setup.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,gDAAgD;AAChD,MAAM,MAAM,YAAY,GAClB,aAAa,GACb,gBAAgB,GAChB,SAAS,GACT,QAAQ,GACR,UAAU,GACV,UAAU,GACV,KAAK,GACL,eAAe,CAAC;AAEtB,wDAAwD;AACxD,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,SAAS,CAAC;AAE7C,uCAAuC;AACvC,MAAM,WAAW,YAAY;IACzB,GAAG,EAAE,YAAY,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,WAAW,CAAC;CACtB;AAyHD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,YAAY,GAAG;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CA2C5F;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,YAAY,GAAG,IAAI,CAwDlE;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,IAAI,CA8CrC;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAYzC"}

package/dist/setup.js

@@ -0,0 +1,275 @@
+/**
+ * @file setup.ts
+ * @description CLI setup command for injecting MCP configuration into various AI tools.
+ * Supports: Claude Code, Claude Desktop, GitHub Copilot, Cursor, Windsurf, Roo Code, Zed, Factory Droid
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+/**
+ * Gets the config file path and format for each CLI tool.
+ * @param cli - Target CLI tool
+ * @param scope - User or project scope
+ * @returns Config file info or null if unsupported
+ */
+function getConfigFileInfo(cli, scope) {
+    const home = os.homedir();
+    const cwd = process.cwd();
+    const configs = {
+        'claude-code': {
+            user: { path: path.join(home, '.claude.json'), wrapperKey: 'mcpServers', serverKey: 'jira' },
+            project: { path: path.join(cwd, '.mcp.json'), wrapperKey: 'mcpServers', serverKey: 'jira' },
+        },
+        'claude-desktop': {
+            user: {
+                path: process.platform === 'darwin'
+                    ? path.join(home, 'Library', 'Application Support', 'Claude', 'claude_desktop_config.json')
+                    : process.platform === 'win32'
+                        ? path.join(process.env.APPDATA || '', 'Claude', 'claude_desktop_config.json')
+                        : path.join(home, '.config', 'Claude', 'claude_desktop_config.json'),
+                wrapperKey: 'mcpServers',
+                serverKey: 'jira',
+            },
+            project: { path: '', wrapperKey: '', serverKey: '' }, // Claude Desktop doesn't support project scope
+        },
+        'copilot': {
+            user: { path: path.join(home, '.mcp.json'), wrapperKey: 'servers', serverKey: 'jira' },
+            project: { path: path.join(cwd, '.vscode', 'mcp.json'), wrapperKey: 'servers', serverKey: 'jira' },
+        },
+        'cursor': {
+            user: { path: path.join(home, '.cursor', 'mcp.json'), wrapperKey: 'mcpServers', serverKey: 'jira' },
+            project: { path: path.join(cwd, '.cursor', 'mcp.json'), wrapperKey: 'mcpServers', serverKey: 'jira' },
+        },
+        'windsurf': {
+            user: { path: path.join(home, '.codeium', 'windsurf', 'mcp_config.json'), wrapperKey: 'mcpServers', serverKey: 'jira' },
+            project: { path: path.join(cwd, '.windsurf', 'mcp_config.json'), wrapperKey: 'mcpServers', serverKey: 'jira' },
+        },
+        'roo-code': {
+            user: { path: path.join(home, '.roo', 'mcp.json'), wrapperKey: 'mcpServers', serverKey: 'jira' },
+            project: { path: path.join(cwd, '.roo', 'mcp.json'), wrapperKey: 'mcpServers', serverKey: 'jira' },
+        },
+        'zed': {
+            user: { path: path.join(home, '.config', 'zed', 'settings.json'), wrapperKey: 'context_servers', serverKey: 'jira' },
+            project: { path: path.join(cwd, '.zed', 'settings.json'), wrapperKey: 'context_servers', serverKey: 'jira' },
+        },
+        'factory-droid': {
+            user: { path: path.join(home, '.factory', 'mcp.json'), wrapperKey: 'mcpServers', serverKey: 'jira' },
+            project: { path: path.join(cwd, '.factory', 'mcp.json'), wrapperKey: 'mcpServers', serverKey: 'jira' },
+        },
+    };
+    const configInfo = configs[cli]?.[scope];
+    if (!configInfo || !configInfo.path) {
+        return null;
+    }
+    return configInfo;
+}
+/**
+ * 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', '@lvmk/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 function injectMcpConfig(options) {
+    const configInfo = 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', 'copilot', 'cursor',
+        'windsurf', 'roo-code', 'zed', 'factory-droid'
+    ];
+    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 @lvmk/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, copilot, cursor,
+                            windsurf, roo-code, zed, factory-droid
+
+  -b, --base-url   Jira base URL (required)
+                   Example: https://jira.example.com
+
+  -u, --username   Jira username (required)
+
+  -p, --password   Jira password (required)
+
+  -s, --scope      Configuration scope (optional, default: user)
+                   Options: user, project
+
+Examples:
+  # Add to Claude Code user config
+  npx @lvmk/jira-mcp setup -c claude-code -b https://jira.example.com -u admin -p secret
+
+  # Add to Cursor project config
+  npx @lvmk/jira-mcp setup -c cursor -b https://jira.example.com -u admin -p secret -s project
+
+  # Add to GitHub Copilot (VS Code)
+  npx @lvmk/jira-mcp setup -c copilot -b https://jira.example.com -u admin -p secret -s project
+
+Supported CLI Tools:
+  ┌────────────────┬───────────────────────────────────────────────────────┐
+  │ CLI            │ Config File Location                                  │
+  ├────────────────┼───────────────────────────────────────────────────────┤
+  │ claude-code    │ ~/.claude.json (user) | .mcp.json (project)           │
+  │ claude-desktop │ ~/Library/Application Support/Claude/... (user only)  │
+  │ copilot        │ ~/.mcp.json (user) | .vscode/mcp.json (project)       │
+  │ cursor         │ ~/.cursor/mcp.json (user) | .cursor/mcp.json (proj)   │
+  │ windsurf       │ ~/.codeium/windsurf/mcp_config.json (user)            │
+  │ roo-code       │ ~/.roo/mcp.json (user) | .roo/mcp.json (project)      │
+  │ zed            │ ~/.config/zed/settings.json (user)                    │
+  │ factory-droid  │ ~/.factory/mcp.json (user) | .factory/mcp.json (proj) │
+  └────────────────┴───────────────────────────────────────────────────────┘
+`);
+}
+/**
+ * Lists all supported CLI tools.
+ */
+export function printSupportedClis() {
+    console.log(`
+Supported CLI tools:
+  • claude-code     - Claude Code (Anthropic)
+  • claude-desktop  - Claude Desktop App
+  • copilot         - GitHub Copilot (VS Code)
+  • cursor          - Cursor AI Editor
+  • windsurf        - Windsurf (Codeium)
+  • roo-code        - Roo Code
+  • zed             - Zed Editor
+  • factory-droid   - Factory Droid AI
+`);
+}
+//# 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"}