@defai.digital/ax-cli 3.2.0 → 3.4.0

package/dist/mcp/registry.js

@@ -0,0 +1,257 @@
+/**
+ * MCP Server Registry Integration (Phase 5)
+ *
+ * Enables discovery and installation of MCP servers from the GitHub MCP Registry
+ * Provides one-command install and browsing capabilities
+ */
+import axios from 'axios';
+/**
+ * Search the MCP server registry
+ */
+export async function searchRegistry(options = {}) {
+    const { query = '', category, transport, sortBy = 'stars', limit = 20 } = options;
+    try {
+        // Search GitHub for MCP servers
+        const searchQuery = buildGitHubSearchQuery(query, category, transport);
+        const sort = sortBy === 'stars' ? 'stars' : sortBy === 'updated' ? 'updated' : undefined;
+        const response = await axios.get('https://api.github.com/search/repositories', {
+            params: {
+                q: searchQuery,
+                sort,
+                order: 'desc',
+                per_page: Math.min(limit, 100)
+            },
+            headers: {
+                'Accept': 'application/vnd.github.v3+json',
+                'User-Agent': 'ax-cli-mcp-registry'
+            }
+        });
+        // Parse and filter results
+        const servers = response.data.items
+            .map(parseGitHubRepo)
+            .filter((server) => server !== null);
+        return servers;
+    }
+    catch (error) {
+        if (axios.isAxiosError(error) && error.response?.status === 403) {
+            throw new Error('GitHub API rate limit exceeded. Please try again later or set GITHUB_TOKEN env var.');
+        }
+        throw new Error(`Failed to search registry: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+/**
+ * Get details for a specific server from the registry
+ */
+export async function getRegistryServer(nameOrPackage) {
+    try {
+        // Try to find by package name first
+        if (nameOrPackage.startsWith('@')) {
+            const results = await searchRegistry({ query: nameOrPackage, limit: 5 });
+            const match = results.find(s => s.packageName === nameOrPackage);
+            if (match)
+                return match;
+        }
+        // Try to find by repository name
+        const results = await searchRegistry({ query: nameOrPackage, limit: 10 });
+        const match = results.find(s => s.name.toLowerCase() === nameOrPackage.toLowerCase() ||
+            s.displayName.toLowerCase() === nameOrPackage.toLowerCase());
+        return match || null;
+    }
+    catch (error) {
+        throw new Error(`Failed to fetch server details: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+/**
+ * Get popular/featured MCP servers
+ */
+export async function getPopularServers() {
+    return searchRegistry({
+        sortBy: 'stars',
+        limit: 20
+    });
+}
+/**
+ * Get servers by category
+ */
+export async function getServersByCategory(category) {
+    return searchRegistry({
+        category,
+        sortBy: 'stars',
+        limit: 20
+    });
+}
+/**
+ * Generate MCP server configuration from registry entry
+ */
+export function generateConfigFromRegistry(server) {
+    const config = {
+        name: server.name,
+        transport: {
+            type: server.transport
+        }
+    };
+    // Configure based on transport type
+    if (server.transport === 'stdio' && server.packageName) {
+        config.transport = {
+            type: 'stdio',
+            command: 'npx',
+            args: ['-y', server.packageName]
+        };
+    }
+    else if (server.transport === 'http' || server.transport === 'sse') {
+        // For HTTP/SSE servers, we'd need the URL from the repo
+        // This would typically be in the README or package.json
+        config.transport = {
+            type: server.transport,
+            url: server.homepage || `https://${server.name}.com`
+        };
+    }
+    return config;
+}
+/**
+ * Build GitHub search query
+ */
+function buildGitHubSearchQuery(query, category, transport) {
+    const parts = [];
+    // Base search terms
+    parts.push('mcp-server');
+    parts.push('OR');
+    parts.push('model-context-protocol');
+    // Add custom query
+    if (query) {
+        parts.push(query);
+    }
+    // Add topic filter
+    parts.push('topic:mcp');
+    // Add category filter
+    if (category) {
+        parts.push(`topic:${category}`);
+    }
+    // Add transport filter
+    if (transport) {
+        parts.push(`topic:${transport}`);
+    }
+    return parts.join(' ');
+}
+/**
+ * Parse GitHub repository into RegistryServer
+ */
+function parseGitHubRepo(repo) {
+    try {
+        // Extract package name from description or README
+        const packageName = extractPackageName(repo);
+        // Determine transport type from topics
+        const transport = determineTransport(repo.topics || []);
+        // Determine category from topics
+        const category = determineCategory(repo.topics || []);
+        // Check if verified (official modelcontextprotocol org)
+        const verified = repo.owner.login === 'modelcontextprotocol';
+        return {
+            name: extractServerName(repo.name),
+            displayName: repo.name.replace(/-/g, ' ').replace(/\bmcp\b/gi, 'MCP'),
+            description: repo.description || 'No description available',
+            repository: repo.html_url,
+            stars: repo.stargazers_count,
+            category,
+            transport,
+            packageName,
+            installCommand: packageName ? `npx ${packageName}` : 'See repository for installation',
+            verified,
+            author: repo.owner.login,
+            version: undefined, // Would need to query npm or GitHub releases
+            homepage: repo.homepage || repo.html_url
+        };
+    }
+    catch (error) {
+        console.warn(`Failed to parse repository: ${repo.name}`, error);
+        return null;
+    }
+}
+/**
+ * Extract NPM package name from repo metadata
+ */
+function extractPackageName(repo) {
+    // Check if description mentions package name
+    const description = repo.description || '';
+    const packageMatch = description.match(/@[\w-]+\/[\w-]+/);
+    if (packageMatch) {
+        return packageMatch[0];
+    }
+    // For official servers, construct package name
+    if (repo.owner.login === 'modelcontextprotocol' && repo.name.startsWith('server-')) {
+        return `@modelcontextprotocol/${repo.name}`;
+    }
+    return undefined;
+}
+/**
+ * Determine transport type from topics
+ */
+function determineTransport(topics) {
+    if (topics.includes('http') || topics.includes('rest'))
+        return 'http';
+    if (topics.includes('sse') || topics.includes('server-sent-events'))
+        return 'sse';
+    return 'stdio'; // Default
+}
+/**
+ * Determine category from topics
+ */
+function determineCategory(topics) {
+    const categoryMap = {
+        'design': 'design',
+        'figma': 'design',
+        'deployment': 'deployment',
+        'vercel': 'deployment',
+        'database': 'database',
+        'postgres': 'database',
+        'mysql': 'database',
+        'testing': 'testing',
+        'api': 'api',
+        'file-system': 'filesystem',
+        'project-management': 'project-management',
+        'linear': 'project-management',
+        'github': 'version-control',
+        'git': 'version-control'
+    };
+    for (const topic of topics) {
+        if (categoryMap[topic]) {
+            return categoryMap[topic];
+        }
+    }
+    return 'other';
+}
+/**
+ * Extract clean server name from repository name
+ */
+function extractServerName(repoName) {
+    // Remove common prefixes
+    let name = repoName
+        .replace(/^mcp-server-/i, '')
+        .replace(/^server-/i, '')
+        .replace(/^mcp-/i, '');
+    // Convert to lowercase with hyphens
+    name = name.toLowerCase();
+    return name;
+}
+/**
+ * Format registry server for display
+ */
+export function formatRegistryServer(server, compact = false) {
+    if (compact) {
+        const badge = server.verified ? '✓' : '';
+        return `${server.displayName} ${badge} ⭐ ${server.stars} - ${server.description}`;
+    }
+    const lines = [];
+    lines.push(`${server.displayName} ${server.verified ? '(verified)' : ''}`);
+    lines.push(`  Description: ${server.description}`);
+    lines.push(`  Category: ${server.category}`);
+    lines.push(`  Transport: ${server.transport}`);
+    lines.push(`  Stars: ${server.stars}`);
+    lines.push(`  Repository: ${server.repository}`);
+    if (server.packageName) {
+        lines.push(`  Package: ${server.packageName}`);
+    }
+    lines.push(`  Install: ax-cli mcp install ${server.name}`);
+    return lines.join('\n');
+}
+//# sourceMappingURL=registry.js.map

package/dist/mcp/registry.js.map

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

package/dist/mcp/resources.d.ts

@@ -0,0 +1,53 @@
+/**
+ * MCP Resource Management (Phase 4)
+ *
+ * Enables users to reference MCP-exposed resources using @mcp: syntax
+ * Similar to file references, but for database tables, API endpoints, etc.
+ */
+import type { MCPManager } from './client.js';
+export interface MCPResource {
+    /** Resource URI (e.g., database://users, api://endpoints/get-user) */
+    uri: string;
+    /** Human-readable name */
+    name: string;
+    /** Resource description */
+    description?: string;
+    /** MIME type if applicable */
+    mimeType?: string;
+    /** Server that provides this resource */
+    serverName: string;
+    /** Full reference string for user input: @mcp:server/uri */
+    reference: string;
+}
+/**
+ * List all resources from MCP servers
+ */
+export declare function listAllResources(mcpManager: MCPManager): Promise<MCPResource[]>;
+/**
+ * List resources from a specific MCP server
+ */
+export declare function listServerResources(mcpManager: MCPManager, serverName: string): Promise<MCPResource[]>;
+/**
+ * Get resource content from MCP server
+ */
+export declare function getResourceContent(mcpManager: MCPManager, serverName: string, uri: string): Promise<string>;
+/**
+ * Parse @mcp: reference
+ * Format: @mcp:server/uri
+ */
+export declare function parseMCPReference(reference: string): {
+    serverName: string;
+    uri: string;
+} | null;
+/**
+ * Extract all MCP references from text
+ */
+export declare function extractMCPReferences(text: string): string[];
+/**
+ * Replace MCP references in text with actual content
+ */
+export declare function resolveMCPReferences(text: string, mcpManager: MCPManager): Promise<string>;
+/**
+ * Search resources by name or URI
+ */
+export declare function searchResources(resources: MCPResource[], query: string): MCPResource[];

package/dist/mcp/resources.js

@@ -0,0 +1,135 @@
+/**
+ * MCP Resource Management (Phase 4)
+ *
+ * Enables users to reference MCP-exposed resources using @mcp: syntax
+ * Similar to file references, but for database tables, API endpoints, etc.
+ */
+/**
+ * List all resources from MCP servers
+ */
+export async function listAllResources(mcpManager) {
+    const resources = [];
+    const servers = mcpManager.getServers();
+    for (const serverName of servers) {
+        try {
+            const serverResources = await listServerResources(mcpManager, serverName);
+            resources.push(...serverResources);
+        }
+        catch (error) {
+            // Silently skip servers that don't support resources
+            console.warn(`Server "${serverName}" does not support resources or failed to list them`);
+        }
+    }
+    return resources;
+}
+/**
+ * List resources from a specific MCP server
+ */
+export async function listServerResources(mcpManager, serverName) {
+    try {
+        // Get the client for this server
+        const client = mcpManager.clients.get(serverName);
+        if (!client) {
+            return [];
+        }
+        // Try to list resources
+        const result = await client.listResources();
+        // Convert to our resource format
+        return result.resources.map((resource) => ({
+            uri: resource.uri,
+            name: resource.name || resource.uri,
+            description: resource.description,
+            mimeType: resource.mimeType,
+            serverName,
+            reference: `@mcp:${serverName}/${resource.uri}`
+        }));
+    }
+    catch (error) {
+        // Server doesn't support resources
+        return [];
+    }
+}
+/**
+ * Get resource content from MCP server
+ */
+export async function getResourceContent(mcpManager, serverName, uri) {
+    try {
+        const client = mcpManager.clients.get(serverName);
+        if (!client) {
+            throw new Error(`Server "${serverName}" not connected`);
+        }
+        const result = await client.readResource({ uri });
+        // Extract text content
+        if (result.contents && result.contents.length > 0) {
+            const content = result.contents[0];
+            if (content.text) {
+                return content.text;
+            }
+            if (content.blob) {
+                // Handle base64 encoded content
+                return Buffer.from(content.blob, 'base64').toString('utf-8');
+            }
+        }
+        return '';
+    }
+    catch (error) {
+        throw new Error(`Failed to read resource ${uri}: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+/**
+ * Parse @mcp: reference
+ * Format: @mcp:server/uri
+ */
+export function parseMCPReference(reference) {
+    if (!reference.startsWith('@mcp:')) {
+        return null;
+    }
+    const withoutPrefix = reference.substring(5); // Remove '@mcp:'
+    const slashIndex = withoutPrefix.indexOf('/');
+    if (slashIndex === -1) {
+        return null;
+    }
+    const serverName = withoutPrefix.substring(0, slashIndex);
+    const uri = withoutPrefix.substring(slashIndex + 1);
+    return { serverName, uri };
+}
+/**
+ * Extract all MCP references from text
+ */
+export function extractMCPReferences(text) {
+    const pattern = /@mcp:[a-z0-9_-]+\/[^\s]+/gi;
+    const matches = text.match(pattern);
+    return matches || [];
+}
+/**
+ * Replace MCP references in text with actual content
+ */
+export async function resolveMCPReferences(text, mcpManager) {
+    const references = extractMCPReferences(text);
+    let result = text;
+    for (const reference of references) {
+        const parsed = parseMCPReference(reference);
+        if (!parsed)
+            continue;
+        try {
+            const content = await getResourceContent(mcpManager, parsed.serverName, parsed.uri);
+            // Replace reference with content (with context)
+            result = result.replace(reference, `\n--- Resource: ${reference} ---\n${content}\n--- End Resource ---\n`);
+        }
+        catch (error) {
+            // Replace with error message
+            result = result.replace(reference, `[Error: Could not load resource ${reference}]`);
+        }
+    }
+    return result;
+}
+/**
+ * Search resources by name or URI
+ */
+export function searchResources(resources, query) {
+    const lowerQuery = query.toLowerCase();
+    return resources.filter(resource => resource.name.toLowerCase().includes(lowerQuery) ||
+        resource.uri.toLowerCase().includes(lowerQuery) ||
+        (resource.description && resource.description.toLowerCase().includes(lowerQuery)));
+}
+//# sourceMappingURL=resources.js.map

package/dist/mcp/resources.js.map

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

package/dist/mcp/templates.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Pre-configured MCP server templates for popular services
+ * Enables one-command setup: ax-cli mcp add <name> --template
+ */
+import { MCPServerConfig } from '../schemas/settings-schemas.js';
+export interface MCPServerTemplate {
+    name: string;
+    description: string;
+    category: 'design' | 'deployment' | 'testing' | 'monitoring' | 'backend' | 'version-control';
+    officialServer: boolean;
+    config: MCPServerConfig;
+    requiredEnv: Array<{
+        name: string;
+        description: string;
+        url?: string;
+    }>;
+    setupInstructions: string;
+    usageExamples: string[];
+    troubleshooting: Array<{
+        issue: string;
+        solution: string;
+    }>;
+}
+/**
+ * Pre-configured templates for popular MCP servers
+ * Focus on front-end development tools
+ */
+export declare const TEMPLATES: Record<string, MCPServerTemplate>;
+/**
+ * Get all available template names
+ */
+export declare function getTemplateNames(): string[];
+/**
+ * Get template by name
+ */
+export declare function getTemplate(name: string): MCPServerTemplate | undefined;
+/**
+ * Get templates by category
+ */
+export declare function getTemplatesByCategory(category: MCPServerTemplate['category']): MCPServerTemplate[];
+/**
+ * Search templates by keyword
+ */
+export declare function searchTemplates(query: string): MCPServerTemplate[];
+/**
+ * Check if a template exists
+ */
+export declare function hasTemplate(name: string): boolean;
+/**
+ * Generate MCP config from template with environment variables
+ */
+export declare function generateConfigFromTemplate(templateName: string, envVars: Record<string, string>): MCPServerConfig;