@khanglvm/jira-mcp 1.3.0

package/dist/index.js

@@ -0,0 +1,228 @@
+#!/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';
+// Export MCP registry types for external use
+export * from './types/mcp-config.js';
+export { createRegistry, createRegistryFromConfig, McpRegistry } from './mcp-registry.js';
+export { fetchMcpConfig, clearCache, getCacheStatus } from './config-fetcher.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: '@khanglvm/jira-mcp',
+    version: '1.0.0',
+};
+/**
+ * Prints general help message.
+ */
+function printHelp() {
+    console.log(`
+@khanglvm/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 @khanglvm/jira-mcp
+
+  2. Setup Mode
+     Inject MCP configuration into AI tool config files.
+
+     Usage:
+       npx @khanglvm/jira-mcp setup -c <cli> -b <url> -u <user> -p <pass> [-s <scope>]
+
+     Run 'npx @khanglvm/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 @khanglvm/jira-mcp
+
+  # Setup for Claude Code
+  npx @khanglvm/jira-mcp setup -c claude-code -b https://jira.example.com -u admin -p secret
+
+  # Setup for Cursor (project scope)
+  npx @khanglvm/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
+ */
+async 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 = await 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
+(async () => {
+    if (await 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":";AACA;;;;;;GAMG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EACH,qBAAqB,EACrB,sBAAsB,GACzB,MAAM,oCAAoC,CAAC;AAE5C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACvD,6CAA6C;AAC7C,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;AACjF,OAAO,EACH,gBAAgB,EAChB,oBAAoB,EACpB,iBAAiB,EACjB,qBAAqB,EACrB,kBAAkB,EAClB,sBAAsB,EACtB,qBAAqB,EACrB,yBAAyB,EACzB,eAAe,EACf,mBAAmB,GACtB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACH,cAAc,EACd,eAAe,EACf,cAAc,EACd,kBAAkB,GACrB,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,MAAM,WAAW,GAAG;IAChB,IAAI,EAAE,oBAAoB;IAC1B,OAAO,EAAE,OAAO;CACnB,CAAC;AAEF;;GAEG;AACH,SAAS,SAAS;IACd,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuCf,CAAC,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,KAAK,UAAU,iBAAiB;IAC5B,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAEnC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACpB,OAAO,KAAK,CAAC,CAAC,6BAA6B;IAC/C,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IAExB,QAAQ,OAAO,EAAE,CAAC;QACd,KAAK,QAAQ,CAAC;QACd,KAAK,IAAI,CAAC;QACV,KAAK,MAAM;YACP,SAAS,EAAE,CAAC;YACZ,OAAO,IAAI,CAAC;QAEhB,KAAK,WAAW,CAAC;QACjB,KAAK,IAAI;YACL,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;YACjC,OAAO,IAAI,CAAC;QAEhB,KAAK,WAAW;YACZ,kBAAkB,EAAE,CAAC;YACrB,OAAO,IAAI,CAAC;QAEhB,KAAK,OAAO,CAAC,CAAC,CAAC;YACX,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAEhC,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,IAAI,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;gBACrF,cAAc,EAAE,CAAC;gBACjB,OAAO,IAAI,CAAC;YAChB,CAAC;YAED,MAAM,OAAO,GAAG,cAAc,CAAC,SAAS,CAAC,CAAC;YAC1C,IAAI,CAAC,OAAO,EAAE,CAAC;gBACX,OAAO,CAAC,KAAK,CAAC,wDAAwD,CAAC,CAAC;gBACxE,cAAc,EAAE,CAAC;gBACjB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACpB,CAAC;YAED,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,OAAO,CAAC,CAAC;YAC9C,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YAE5B,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBAClB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACpB,CAAC;YACD,OAAO,IAAI,CAAC;QAChB,CAAC;QAED;YACI,0DAA0D;YAC1D,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC1B,OAAO,CAAC,KAAK,CAAC,mBAAmB,OAAO,EAAE,CAAC,CAAC;gBAC5C,SAAS,EAAE,CAAC;gBACZ,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACpB,CAAC;YACD,OAAO,KAAK,CAAC;IACrB,CAAC;AACL,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,YAAY;IACvB,mDAAmD;IACnD,IAAI,MAAM,CAAC;IACX,IAAI,CAAC;QACD,MAAM,GAAG,UAAU,EAAE,CAAC;IAC1B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAE,KAAe,CAAC,OAAO,CAAC,CAAC;QACxC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;IAED,yBAAyB;IACzB,MAAM,UAAU,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC;IAE1C,uBAAuB;IACvB,MAAM,UAAU,GAAG,gBAAgB,CAAC,UAAU,CAAC,CAAC;IAChD,MAAM,WAAW,GAAG,iBAAiB,CAAC,UAAU,CAAC,CAAC;IAClD,MAAM,YAAY,GAAG,kBAAkB,CAAC,UAAU,CAAC,CAAC;IACpD,MAAM,eAAe,GAAG,qBAAqB,CAAC,UAAU,CAAC,CAAC;IAC1D,MAAM,SAAS,GAAG,eAAe,CAAC,UAAU,CAAC,CAAC;IAE9C,iDAAiD;IACjD,+FAA+F;IAC/F,8DAA8D;IAC9D,MAAM,eAAe,GAA+F;QAChH,GAAG,UAAU;QACb,GAAG,WAAW;QACd,GAAG,YAAY;QACf,GAAG,eAAe;QAClB,GAAG,SAAS;KACf,CAAC;IAEF,+BAA+B;IAC/B,MAAM,kBAAkB,GAAG;QACvB,GAAG,oBAAoB;QACvB,GAAG,qBAAqB;QACxB,GAAG,sBAAsB;QACzB,GAAG,yBAAyB;QAC5B,GAAG,mBAAmB;KACzB,CAAC;IAEF,oBAAoB;IACpB,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,WAAW,EAAE;QACnC,YAAY,EAAE;YACV,KAAK,EAAE,EAAE;SACZ;KACJ,CAAC,CAAC;IAEH,8BAA8B;IAC9B,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,IAAI,EAAE;QACxD,OAAO;YACH,KAAK,EAAE,kBAAkB;SAC5B,CAAC;IACN,CAAC,CAAC,CAAC;IAEH,6BAA6B;IAC7B,MAAM,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QAC9D,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;QAEjD,MAAM,OAAO,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;QACtC,IAAI,CAAC,OAAO,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC;QAC7C,CAAC;QAED,IAAI,CAAC;YACD,8DAA8D;YAC9D,OAAO,MAAM,OAAO,CAAC,IAAW,CAAC,CAAC;QACtC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,oCAAoC;YACpC,IAAI,KAAK,YAAY,YAAY,EAAE,CAAC;gBAChC,OAAO;oBACH,OAAO,EAAE;wBACL;4BACI,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAChB;gCACI,KAAK,EAAE,IAAI;gCACX,OAAO,EAAE,KAAK,CAAC,OAAO;gCACtB,UAAU,EAAE,KAAK,CAAC,UAAU;gCAC5B,OAAO,EAAE,KAAK,CAAC,IAAI;6BACtB,EACD,IAAI,EACJ,CAAC,CACJ;yBACJ;qBACJ;oBACD,OAAO,EAAE,IAAI;iBAChB,CAAC;YACN,CAAC;YAED,6BAA6B;YAC7B,MAAM,KAAK,CAAC;QAChB,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,qCAAqC;IACrC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC,wFAAwF;IACxF,OAAO,CAAC,KAAK,CAAC,0CAA0C,MAAM,CAAC,aAAa,EAAE,CAAC,CAAC;AACpF,CAAC;AAED,mBAAmB;AACnB,CAAC,KAAK,IAAI,EAAE;IACR,IAAI,MAAM,iBAAiB,EAAE,EAAE,CAAC;QAC5B,qCAAqC;QACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;SAAM,CAAC;QACJ,oBAAoB;QACpB,YAAY,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;YAC3B,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;YACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,CAAC,CAAC,CAAC;IACP,CAAC;AACL,CAAC,CAAC,EAAE,CAAC"}

package/dist/mcp-registry.d.ts

@@ -0,0 +1,106 @@
+/**
+ * @file mcp-registry.ts
+ * @description MCP client registry for dynamic tool configuration.
+ * Provides query methods for accessing MCP client configs by scope/platform.
+ */
+import type { McpConfigSchema, McpClientConfig, ConfigScope, TransportType, WrapperKey } from './types/mcp-config.js';
+/**
+ * MCP Registry class for querying client configurations.
+ * Caches config data and provides filtering methods.
+ */
+export declare class McpRegistry {
+    private config;
+    private clients;
+    constructor(config: McpConfigSchema);
+    /**
+     * Gets all client configurations.
+     */
+    getAllClients(): McpClientConfig[];
+    /**
+     * Gets a specific client by name.
+     * Returns null if client not found.
+     */
+    getClient(name: string): McpClientConfig | null;
+    /**
+     * Gets clients filtered by scope capability.
+     * Returns clients that support the given scope.
+     */
+    getClientsByScope(scope: ConfigScope): McpClientConfig[];
+    /**
+     * Gets clients that have detectable config paths for the platform.
+     */
+    getDetectableClients(platform: NodeJS.Platform): McpClientConfig[];
+    /**
+     * Gets config file paths for a client on the current platform.
+     */
+    getConfigPaths(clientName: string, platform: NodeJS.Platform): string[];
+    /**
+     * Gets scopes supported by a client.
+     */
+    getScopesForClient(name: string): ConfigScope[];
+    /**
+     * Checks if a client supports a specific scope.
+     */
+    supportsScope(name: string, scope: ConfigScope): boolean;
+    /**
+     * Gets transport types supported by a client.
+     */
+    getTransportsForClient(name: string): TransportType[];
+    /**
+     * Gets wrapper key for a client (mcpServers, mcp, servers, etc.).
+     */
+    getWrapperKey(name: string): WrapperKey | null;
+    /**
+     * Gets clients filtered by wrapper key.
+     * Useful for grouping clients by config format.
+     */
+    getClientsByWrapperKey(wrapperKey: WrapperKey): McpClientConfig[];
+    /**
+     * Gets clients that support a specific transport type.
+     */
+    getClientsByTransport(transport: TransportType): McpClientConfig[];
+    /**
+     * Gets CLI commands for a client (if available).
+     */
+    getCliCommands(name: string): McpClientConfig['cli'];
+    /**
+     * Checks if a client has CLI management support.
+     */
+    hasCliSupport(name: string): boolean;
+    /**
+     * Gets config format type for a client (json, yaml, toml).
+     */
+    getConfigFormat(name: string): string;
+    /**
+     * Gets all client names.
+     */
+    getClientNames(): string[];
+    /**
+     * Searches clients by name (case-insensitive partial match).
+     */
+    searchClients(query: string): McpClientConfig[];
+    /**
+     * Gets registry metadata.
+     */
+    getMetadata(): {
+        version: string;
+        lastUpdated: string;
+        clientCount: number;
+    };
+}
+/**
+ * Creates an MCP registry instance by fetching config.
+ * This is the main entry point for using the registry.
+ *
+ * @param options - Fetch options for getting config
+ * @returns Initialized MCP registry
+ */
+export declare function createRegistry(options?: {
+    forceRefresh?: boolean;
+}): Promise<McpRegistry>;
+/**
+ * Creates a registry from existing config data.
+ * Useful for testing or using cached config.
+ */
+export declare function createRegistryFromConfig(config: McpConfigSchema): McpRegistry;
+//# sourceMappingURL=mcp-registry.d.ts.map

package/dist/mcp-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-registry.d.ts","sourceRoot":"","sources":["../src/mcp-registry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACR,eAAe,EACf,eAAe,EACf,WAAW,EACX,aAAa,EACb,UAAU,EACb,MAAM,uBAAuB,CAAC;AAI/B;;;GAGG;AACH,qBAAa,WAAW;IAGR,OAAO,CAAC,MAAM;IAF1B,OAAO,CAAC,OAAO,CAA+B;gBAE1B,MAAM,EAAE,eAAe;IAI3C;;OAEG;IACH,aAAa,IAAI,eAAe,EAAE;IAIlC;;;OAGG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI;IAI/C;;;OAGG;IACH,iBAAiB,CAAC,KAAK,EAAE,WAAW,GAAG,eAAe,EAAE;IAMxD;;OAEG;IACH,oBAAoB,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,GAAG,eAAe,EAAE;IAQlE;;OAEG;IACH,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,GAAG,MAAM,EAAE;IAgBvE;;OAEG;IACH,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,EAAE;IAK/C;;OAEG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,OAAO;IAIxD;;OAEG;IACH,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,EAAE;IAKrD;;OAEG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAK9C;;;OAGG;IACH,sBAAsB,CAAC,UAAU,EAAE,UAAU,GAAG,eAAe,EAAE;IAMjE;;OAEG;IACH,qBAAqB,CAAC,SAAS,EAAE,aAAa,GAAG,eAAe,EAAE;IAMlE;;OAEG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,CAAC,KAAK,CAAC;IAKpD;;OAEG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAKpC;;OAEG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAKrC;;OAEG;IACH,cAAc,IAAI,MAAM,EAAE;IAI1B;;OAEG;IACH,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe,EAAE;IAQ/C;;OAEG;IACH,WAAW,IAAI;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE;CAO/E;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAAC,OAAO,CAAC,EAAE;IAAE,YAAY,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAAC,WAAW,CAAC,CAG/F;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,eAAe,GAAG,WAAW,CAE7E"}

package/dist/mcp-registry.js

@@ -0,0 +1,168 @@
+/**
+ * @file mcp-registry.ts
+ * @description MCP client registry for dynamic tool configuration.
+ * Provides query methods for accessing MCP client configs by scope/platform.
+ */
+import { fetchMcpConfig } from './config-fetcher.js';
+import { mapPlatform } from './utils/path-resolver.js';
+/**
+ * MCP Registry class for querying client configurations.
+ * Caches config data and provides filtering methods.
+ */
+export class McpRegistry {
+    config;
+    clients;
+    constructor(config) {
+        this.config = config;
+        this.clients = new Map(Object.entries(config.clients));
+    }
+    /**
+     * Gets all client configurations.
+     */
+    getAllClients() {
+        return Array.from(this.clients.values());
+    }
+    /**
+     * Gets a specific client by name.
+     * Returns null if client not found.
+     */
+    getClient(name) {
+        return this.clients.get(name) || null;
+    }
+    /**
+     * Gets clients filtered by scope capability.
+     * Returns clients that support the given scope.
+     */
+    getClientsByScope(scope) {
+        return this.getAllClients().filter(client => client.scopes.includes(scope));
+    }
+    /**
+     * Gets clients that have detectable config paths for the platform.
+     */
+    getDetectableClients(platform) {
+        const platformKey = mapPlatform(platform);
+        return this.getAllClients().filter(client => {
+            const platformLocations = client.configLocations[platformKey];
+            return platformLocations && Object.keys(platformLocations).length > 0;
+        });
+    }
+    /**
+     * Gets config file paths for a client on the current platform.
+     */
+    getConfigPaths(clientName, platform) {
+        const client = this.getClient(clientName);
+        if (!client) {
+            return [];
+        }
+        const platformKey = mapPlatform(platform);
+        const platformLocations = client.configLocations[platformKey];
+        if (!platformLocations) {
+            return [];
+        }
+        return Object.values(platformLocations).filter(p => typeof p === 'string' && p.length > 0);
+    }
+    /**
+     * Gets scopes supported by a client.
+     */
+    getScopesForClient(name) {
+        const client = this.getClient(name);
+        return client?.scopes || [];
+    }
+    /**
+     * Checks if a client supports a specific scope.
+     */
+    supportsScope(name, scope) {
+        return this.getScopesForClient(name).includes(scope);
+    }
+    /**
+     * Gets transport types supported by a client.
+     */
+    getTransportsForClient(name) {
+        const client = this.getClient(name);
+        return client?.transportSupport || [];
+    }
+    /**
+     * Gets wrapper key for a client (mcpServers, mcp, servers, etc.).
+     */
+    getWrapperKey(name) {
+        const client = this.getClient(name);
+        return client?.configFormat.wrapperKey || null;
+    }
+    /**
+     * Gets clients filtered by wrapper key.
+     * Useful for grouping clients by config format.
+     */
+    getClientsByWrapperKey(wrapperKey) {
+        return this.getAllClients().filter(client => client.configFormat.wrapperKey === wrapperKey);
+    }
+    /**
+     * Gets clients that support a specific transport type.
+     */
+    getClientsByTransport(transport) {
+        return this.getAllClients().filter(client => client.transportSupport.includes(transport));
+    }
+    /**
+     * Gets CLI commands for a client (if available).
+     */
+    getCliCommands(name) {
+        const client = this.getClient(name);
+        return client?.cli;
+    }
+    /**
+     * Checks if a client has CLI management support.
+     */
+    hasCliSupport(name) {
+        const commands = this.getCliCommands(name);
+        return commands !== undefined && Object.keys(commands).length > 0;
+    }
+    /**
+     * Gets config format type for a client (json, yaml, toml).
+     */
+    getConfigFormat(name) {
+        const client = this.getClient(name);
+        return client?.configFormat.format || 'json';
+    }
+    /**
+     * Gets all client names.
+     */
+    getClientNames() {
+        return Array.from(this.clients.keys());
+    }
+    /**
+     * Searches clients by name (case-insensitive partial match).
+     */
+    searchClients(query) {
+        const lowerQuery = query.toLowerCase();
+        return this.getAllClients().filter(client => client.name.toLowerCase().includes(lowerQuery) ||
+            client.vendor?.toLowerCase().includes(lowerQuery));
+    }
+    /**
+     * Gets registry metadata.
+     */
+    getMetadata() {
+        return {
+            version: this.config.version,
+            lastUpdated: this.config.lastUpdated,
+            clientCount: this.clients.size,
+        };
+    }
+}
+/**
+ * Creates an MCP registry instance by fetching config.
+ * This is the main entry point for using the registry.
+ *
+ * @param options - Fetch options for getting config
+ * @returns Initialized MCP registry
+ */
+export async function createRegistry(options) {
+    const config = await fetchMcpConfig(options);
+    return new McpRegistry(config);
+}
+/**
+ * Creates a registry from existing config data.
+ * Useful for testing or using cached config.
+ */
+export function createRegistryFromConfig(config) {
+    return new McpRegistry(config);
+}
+//# sourceMappingURL=mcp-registry.js.map

package/dist/mcp-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-registry.js","sourceRoot":"","sources":["../src/mcp-registry.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.
+ * Dynamically supports all MCP clients from the registry (14 tools).
+ */
+/** Supported CLI tools for MCP configuration - all 14 tools from registry */
+export type SupportedCli = 'claude-code' | 'claude-desktop' | 'github-copilot' | 'cursor' | 'windsurf' | 'roo-code' | 'zed' | 'factory-droid' | 'antigravity' | 'gemini-cli' | 'opencode' | 'vscode-copilot' | 'jetbrains-copilot' | 'codex-cli';
+/** 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): Promise<{
+    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;AAOH,6EAA6E;AAC7E,MAAM,MAAM,YAAY,GAClB,aAAa,GACb,gBAAgB,GAChB,gBAAgB,GAChB,QAAQ,GACR,UAAU,GACV,UAAU,GACV,KAAK,GACL,eAAe,GACf,aAAa,GACb,YAAY,GACZ,UAAU,GACV,gBAAgB,GAChB,mBAAmB,GACnB,WAAW,CAAC;AAElB,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;AA+HD;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CA2C3G;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,YAAY,GAAG,IAAI,CAyDlE;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,IAAI,CA6BrC;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAkBzC"}