@khanglvm/jira-mcp 1.3.0

package/dist/config-fetcher.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @file config-fetcher.ts
+ * @description HTTP config fetcher with hybrid caching (memory + file).
+ * Fetches remote MCP config from GitHub with offline fallback support.
+ */
+import type { McpConfigSchema, FetchOptions, ConfigFileType } from './types/mcp-config.js';
+/**
+ * Detects config file type from extension.
+ */
+export declare function detectConfigFileType(filePath: string): ConfigFileType;
+/**
+ * Main function to fetch MCP configuration.
+ * Cache hierarchy: memory -> remote -> file -> error
+ */
+export declare function fetchMcpConfig(options?: FetchOptions): Promise<McpConfigSchema>;
+/**
+ * Clears all caches (memory and file).
+ * Useful for testing or forcing fresh fetch.
+ */
+export declare function clearCache(): void;
+/**
+ * Gets current cache status.
+ * Useful for debugging and monitoring.
+ */
+export declare function getCacheStatus(): {
+    memory: boolean;
+    file: boolean;
+    age?: number;
+};
+//# sourceMappingURL=config-fetcher.d.ts.map

package/dist/config-fetcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-fetcher.d.ts","sourceRoot":"","sources":["../src/config-fetcher.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,KAAK,EACR,eAAe,EACf,YAAY,EAEZ,cAAc,EACjB,MAAM,uBAAuB,CAAC;AA6G/B;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,CAarE;AAsGD;;;GAGG;AACH,wBAAsB,cAAc,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,eAAe,CAAC,CA4CrF;AAED;;;GAGG;AACH,wBAAgB,UAAU,IAAI,IAAI,CAWjC;AAED;;;GAGG;AACH,wBAAgB,cAAc,IAAI;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,OAAO,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,CAWjF"}

package/dist/config-fetcher.js

@@ -0,0 +1,279 @@
+/**
+ * @file config-fetcher.ts
+ * @description HTTP config fetcher with hybrid caching (memory + file).
+ * Fetches remote MCP config from GitHub with offline fallback support.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+import { z } from 'zod';
+// Constants
+const REMOTE_URL = 'https://raw.githubusercontent.com/khanglvm/aic/main/mcp/mcp-conf.json';
+const CACHE_TTL = 60 * 1000; // 1 minute
+const TIMEOUT = 10000; // 10 seconds
+const DEFAULT_RETRIES = 3;
+// In-memory cache entry
+let memoryCache = null;
+/**
+ * Zod schema for MCP config validation.
+ * Ensures remote JSON has required fields.
+ */
+const mcpConfigSchema = z.object({
+    $schema: z.string().optional(),
+    $id: z.string().optional(),
+    version: z.string(),
+    lastUpdated: z.string(),
+    description: z.string().optional(),
+    clients: z.record(z.object({
+        name: z.string(),
+        vendor: z.string().optional(),
+        description: z.string().optional(),
+        docsUrl: z.string().optional(),
+        configLocations: z.record(z.record(z.string())),
+        configFormat: z.object({
+            wrapperKey: z.enum(['mcpServers', 'mcp', 'servers', 'context_servers', 'mcp_servers']),
+            serverSchema: z.object({
+                command: z.any().optional(),
+                args: z.any().optional(),
+                url: z.any().optional(),
+                headers: z.any().optional(),
+                env: z.any().optional(),
+                environment: z.any().optional(),
+            }).passthrough(),
+            format: z.enum(['json', 'yaml', 'toml']).optional(),
+        }).passthrough(),
+        cli: z.any().optional(),
+        scopes: z.array(z.string()),
+        transportSupport: z.array(z.string()),
+        notes: z.array(z.string()).optional(),
+    })),
+});
+/**
+ * Gets the cache file path for MCP config.
+ * Platform-specific: ~/.cache/jira-mcp/mcp-conf.json
+ */
+function getCacheFilePath() {
+    return path.join(os.homedir(), '.cache', 'jira-mcp', 'mcp-conf.json');
+}
+/**
+ * Ensures cache directory exists with proper permissions.
+ */
+function ensureCacheDir() {
+    const cacheDir = path.dirname(getCacheFilePath());
+    if (!fs.existsSync(cacheDir)) {
+        fs.mkdirSync(cacheDir, { recursive: true, mode: 0o700 });
+    }
+}
+/**
+ * Persists config data to file cache.
+ * Uses secure permissions (0600 - owner read/write only).
+ */
+function persistToFile(data, etag) {
+    try {
+        ensureCacheDir();
+        const cacheEntry = {
+            data,
+            etag,
+            fetchedAt: Date.now(),
+            ttl: CACHE_TTL,
+        };
+        const filePath = getCacheFilePath();
+        fs.writeFileSync(filePath, JSON.stringify(cacheEntry, null, 2), { mode: 0o600 });
+    }
+    catch (error) {
+        console.warn(`Warning: Failed to write cache file: ${error.message}`);
+    }
+}
+/**
+ * Reads config from file cache.
+ * Returns null if cache doesn't exist or is invalid.
+ */
+function readFromFile() {
+    try {
+        const filePath = getCacheFilePath();
+        if (!fs.existsSync(filePath)) {
+            return null;
+        }
+        const content = fs.readFileSync(filePath, 'utf-8');
+        const cacheEntry = JSON.parse(content);
+        // Validate cache entry structure
+        if (!cacheEntry.data || typeof cacheEntry.data !== 'object') {
+            return null;
+        }
+        return cacheEntry.data;
+    }
+    catch (error) {
+        console.warn(`Warning: Failed to read cache file: ${error.message}`);
+        return null;
+    }
+}
+/**
+ * Detects config file type from extension.
+ */
+export function detectConfigFileType(filePath) {
+    const ext = path.extname(filePath).toLowerCase();
+    switch (ext) {
+        case '.json':
+            return 'json';
+        case '.yaml':
+        case '.yml':
+            return 'yaml';
+        case '.toml':
+            return 'toml';
+        default:
+            return 'json'; // default
+    }
+}
+/**
+ * Parses config file based on type (JSON or YAML).
+ * For YAML, attempts to load js-yaml package if available.
+ */
+async function parseConfigFile(filePath, content) {
+    const fileType = detectConfigFileType(filePath);
+    if (fileType === 'yaml') {
+        try {
+            // Try to load js-yaml dynamically (optional dependency)
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const yamlModule = await import('js-yaml').catch(() => null);
+            if (!yamlModule) {
+                throw new Error('YAML parsing requires js-yaml package.\n' +
+                    'Install it with: npm install js-yaml');
+            }
+            return yamlModule.load(content);
+        }
+        catch (error) {
+            throw new Error(`Failed to parse YAML file: ${error.message}`);
+        }
+    }
+    // Default to JSON parsing
+    return JSON.parse(content);
+}
+/**
+ * Sleep utility for exponential backoff.
+ */
+function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+/**
+ * Fetches remote config with retry logic and timeout.
+ * Implements exponential backoff: 1s, 2s, 4s.
+ */
+async function fetchWithRetry(url, retries = DEFAULT_RETRIES) {
+    for (let attempt = 0; attempt < retries; attempt++) {
+        try {
+            const controller = new AbortController();
+            const timeoutId = setTimeout(() => controller.abort(), TIMEOUT);
+            const response = await fetch(url, {
+                signal: controller.signal,
+                headers: {
+                    'Accept': 'application/json',
+                    'User-Agent': '@khanglvm/jira-mcp',
+                },
+            });
+            clearTimeout(timeoutId);
+            if (!response.ok) {
+                throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+            }
+            return {
+                data: await response.text(),
+                etag: response.headers.get('ETag') || undefined,
+            };
+        }
+        catch (error) {
+            if (error.name === 'AbortError') {
+                throw new Error(`Request timeout after ${TIMEOUT}ms`);
+            }
+            if (attempt === retries - 1) {
+                throw error;
+            }
+            const backoffMs = 1000 * Math.pow(2, attempt);
+            console.warn(`Fetch attempt ${attempt + 1} failed, retrying in ${backoffMs}ms...`);
+            await sleep(backoffMs);
+        }
+    }
+    throw new Error('All fetch attempts failed');
+}
+/**
+ * Validates MCP config schema using Zod.
+ */
+function validateConfig(data) {
+    const result = mcpConfigSchema.safeParse(data);
+    if (!result.success) {
+        const errors = result.error.errors
+            .map(e => `  - ${e.path.join('.')}: ${e.message}`)
+            .join('\n');
+        throw new Error(`Invalid MCP config schema:\n${errors}`);
+    }
+    return result.data;
+}
+/**
+ * Main function to fetch MCP configuration.
+ * Cache hierarchy: memory -> remote -> file -> error
+ */
+export async function fetchMcpConfig(options) {
+    const forceRefresh = options?.forceRefresh ?? false;
+    const retries = options?.retries ?? DEFAULT_RETRIES;
+    // 1. Check memory cache first
+    if (!forceRefresh && memoryCache && Date.now() - memoryCache.fetchedAt < memoryCache.ttl) {
+        return memoryCache.data;
+    }
+    // Clear expired cache
+    if (memoryCache) {
+        memoryCache = null;
+    }
+    // 2. Try remote fetch
+    if (options?.timeout === 0) {
+        throw new Error('Remote fetch disabled by configuration');
+    }
+    try {
+        const { data, etag } = await fetchWithRetry(REMOTE_URL, retries);
+        const validated = validateConfig(JSON.parse(data));
+        // Update caches
+        memoryCache = { data: validated, etag, fetchedAt: Date.now(), ttl: CACHE_TTL };
+        persistToFile(validated, etag);
+        return validated;
+    }
+    catch (error) {
+        console.warn(`Remote fetch failed: ${error.message}`);
+        // 3. Fallback to file cache
+        const fileData = readFromFile();
+        if (fileData) {
+            console.info('Using cached configuration from file');
+            memoryCache = { data: fileData, fetchedAt: Date.now(), ttl: CACHE_TTL };
+            return fileData;
+        }
+        throw new Error('Failed to fetch MCP configuration and no cached data available.\n' +
+            'Please check your internet connection and try again.');
+    }
+}
+/**
+ * Clears all caches (memory and file).
+ * Useful for testing or forcing fresh fetch.
+ */
+export function clearCache() {
+    memoryCache = null;
+    try {
+        const filePath = getCacheFilePath();
+        if (fs.existsSync(filePath)) {
+            fs.unlinkSync(filePath);
+        }
+    }
+    catch (error) {
+        console.warn(`Warning: Failed to clear cache file: ${error.message}`);
+    }
+}
+/**
+ * Gets current cache status.
+ * Useful for debugging and monitoring.
+ */
+export function getCacheStatus() {
+    const memory = memoryCache !== null;
+    const filePath = getCacheFilePath();
+    const file = fs.existsSync(filePath);
+    let age;
+    if (memoryCache) {
+        age = Date.now() - memoryCache.fetchedAt;
+    }
+    return { memory, file, age };
+}
+//# sourceMappingURL=config-fetcher.js.map

package/dist/config-fetcher.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,54 @@
+/**
+ * @file config.ts
+ * @description Configuration module for Jira MCP server.
+ * Handles environment variable parsing and validation.
+ */
+import { z } from 'zod';
+/**
+ * Environment variable schema for Jira configuration.
+ * Validates required and optional configuration values.
+ */
+declare const configSchema: z.ZodObject<{
+    /** Base URL of the Jira instance (e.g., http://jira.example.com:8080) */
+    JIRA_BASE_URL: z.ZodString;
+    /** Username for basic authentication */
+    JIRA_USERNAME: z.ZodString;
+    /** Password for basic authentication */
+    JIRA_PASSWORD: z.ZodString;
+    /** API version (defaults to "2") */
+    JIRA_API_VERSION: z.ZodDefault<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    JIRA_BASE_URL: string;
+    JIRA_USERNAME: string;
+    JIRA_PASSWORD: string;
+    JIRA_API_VERSION: string;
+}, {
+    JIRA_BASE_URL: string;
+    JIRA_USERNAME: string;
+    JIRA_PASSWORD: string;
+    JIRA_API_VERSION?: string | undefined;
+}>;
+/**
+ * Validated configuration type inferred from schema.
+ */
+export type JiraConfig = z.infer<typeof configSchema>;
+/**
+ * Loads and validates configuration from environment variables.
+ * @returns Validated configuration object
+ * @throws Error if required environment variables are missing or invalid
+ */
+export declare function loadConfig(): JiraConfig;
+/**
+ * Constructs the full REST API base URL.
+ * @param config - Validated configuration
+ * @returns Full API base URL (e.g., http://jira.example.com:8080/rest/api/2)
+ */
+export declare function getApiBaseUrl(config: JiraConfig): string;
+/**
+ * Constructs the auth API base URL for session endpoints.
+ * @param config - Validated configuration
+ * @returns Full auth API base URL (e.g., http://jira.example.com:8080/rest/auth/1)
+ */
+export declare function getAuthBaseUrl(config: JiraConfig): string;
+export {};
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,QAAA,MAAM,YAAY;IACd,yEAAyE;;IAEzE,wCAAwC;;IAExC,wCAAwC;;IAExC,oCAAoC;;;;;;;;;;;;EAEtC,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAEtD;;;;GAIG;AACH,wBAAgB,UAAU,IAAI,UAAU,CAwBvC;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAIxD;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAGzD"}

package/dist/config.js

@@ -0,0 +1,66 @@
+/**
+ * @file config.ts
+ * @description Configuration module for Jira MCP server.
+ * Handles environment variable parsing and validation.
+ */
+import { z } from 'zod';
+/**
+ * Environment variable schema for Jira configuration.
+ * Validates required and optional configuration values.
+ */
+const configSchema = z.object({
+    /** Base URL of the Jira instance (e.g., http://jira.example.com:8080) */
+    JIRA_BASE_URL: z.string().url('JIRA_BASE_URL must be a valid URL'),
+    /** Username for basic authentication */
+    JIRA_USERNAME: z.string().min(1, 'JIRA_USERNAME is required'),
+    /** Password for basic authentication */
+    JIRA_PASSWORD: z.string().min(1, 'JIRA_PASSWORD is required'),
+    /** API version (defaults to "2") */
+    JIRA_API_VERSION: z.string().default('2'),
+});
+/**
+ * Loads and validates configuration from environment variables.
+ * @returns Validated configuration object
+ * @throws Error if required environment variables are missing or invalid
+ */
+export function loadConfig() {
+    const result = configSchema.safeParse({
+        JIRA_BASE_URL: process.env.JIRA_BASE_URL,
+        JIRA_USERNAME: process.env.JIRA_USERNAME,
+        JIRA_PASSWORD: process.env.JIRA_PASSWORD,
+        JIRA_API_VERSION: process.env.JIRA_API_VERSION ?? '2',
+    });
+    if (!result.success) {
+        const errors = result.error.errors
+            .map((e) => `  - ${e.path.join('.')}: ${e.message}`)
+            .join('\n');
+        throw new Error(`Jira MCP configuration error:\n${errors}\n\n` +
+            'Required environment variables:\n' +
+            '  JIRA_BASE_URL - Base URL of Jira instance\n' +
+            '  JIRA_USERNAME - Username for authentication\n' +
+            '  JIRA_PASSWORD - Password for authentication\n' +
+            '\nOptional:\n' +
+            '  JIRA_API_VERSION - API version (default: "2")');
+    }
+    return result.data;
+}
+/**
+ * Constructs the full REST API base URL.
+ * @param config - Validated configuration
+ * @returns Full API base URL (e.g., http://jira.example.com:8080/rest/api/2)
+ */
+export function getApiBaseUrl(config) {
+    // Remove trailing slash if present
+    const baseUrl = config.JIRA_BASE_URL.replace(/\/$/, '');
+    return `${baseUrl}/rest/api/${config.JIRA_API_VERSION}`;
+}
+/**
+ * Constructs the auth API base URL for session endpoints.
+ * @param config - Validated configuration
+ * @returns Full auth API base URL (e.g., http://jira.example.com:8080/rest/auth/1)
+ */
+export function getAuthBaseUrl(config) {
+    const baseUrl = config.JIRA_BASE_URL.replace(/\/$/, '');
+    return `${baseUrl}/rest/auth/1`;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1B,yEAAyE;IACzE,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,mCAAmC,CAAC;IAClE,wCAAwC;IACxC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,2BAA2B,CAAC;IAC7D,wCAAwC;IACxC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,2BAA2B,CAAC;IAC7D,oCAAoC;IACpC,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC;CAC5C,CAAC,CAAC;AAOH;;;;GAIG;AACH,MAAM,UAAU,UAAU;IACtB,MAAM,MAAM,GAAG,YAAY,CAAC,SAAS,CAAC;QAClC,aAAa,EAAE,OAAO,CAAC,GAAG,CAAC,aAAa;QACxC,aAAa,EAAE,OAAO,CAAC,GAAG,CAAC,aAAa;QACxC,aAAa,EAAE,OAAO,CAAC,GAAG,CAAC,aAAa;QACxC,gBAAgB,EAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,GAAG;KACxD,CAAC,CAAC;IAEH,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QAClB,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM;aAC7B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;aACnD,IAAI,CAAC,IAAI,CAAC,CAAC;QAChB,MAAM,IAAI,KAAK,CACX,kCAAkC,MAAM,MAAM;YAC9C,mCAAmC;YACnC,+CAA+C;YAC/C,iDAAiD;YACjD,iDAAiD;YACjD,eAAe;YACf,iDAAiD,CACpD,CAAC;IACN,CAAC;IAED,OAAO,MAAM,CAAC,IAAI,CAAC;AACvB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,MAAkB;IAC5C,mCAAmC;IACnC,MAAM,OAAO,GAAG,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACxD,OAAO,GAAG,OAAO,aAAa,MAAM,CAAC,gBAAgB,EAAE,CAAC;AAC5D,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,MAAkB;IAC7C,MAAM,OAAO,GAAG,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACxD,OAAO,GAAG,OAAO,cAAc,CAAC;AACpC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+#!/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
+ */
+export * from './types/mcp-config.js';
+export { createRegistry, createRegistryFromConfig, McpRegistry } from './mcp-registry.js';
+export { fetchMcpConfig, clearCache, getCacheStatus } from './config-fetcher.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;GAMG;AAYH,cAAc,uBAAuB,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,wBAAwB,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAC1F,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC"}