@defai.digital/ax-cli 3.2.0 → 3.4.0

package/dist/mcp/templates.js

@@ -0,0 +1,624 @@
+/**
+ * Pre-configured MCP server templates for popular services
+ * Enables one-command setup: ax-cli mcp add <name> --template
+ */
+/**
+ * Pre-configured templates for popular MCP servers
+ * Focus on front-end development tools
+ */
+export const TEMPLATES = {
+    // ============================================
+    // DESIGN TOOLS
+    // ============================================
+    figma: {
+        name: 'figma',
+        description: 'Official Figma MCP server for design-to-code workflows',
+        category: 'design',
+        officialServer: true,
+        config: {
+            name: 'figma',
+            transport: {
+                type: 'stdio',
+                command: 'npx',
+                args: ['@figma/mcp-server'],
+                env: {}
+            }
+        },
+        requiredEnv: [
+            {
+                name: 'FIGMA_ACCESS_TOKEN',
+                description: 'Personal access token from Figma settings',
+                url: 'https://help.figma.com/hc/en-us/articles/8085703771159'
+            }
+        ],
+        setupInstructions: `
+1. Generate a personal access token at https://figma.com/settings
+2. Set environment variable: export FIGMA_ACCESS_TOKEN="your_token"
+3. Run: ax-cli mcp add figma --template
+4. Test: ax-cli mcp test figma
+    `.trim(),
+        usageExamples: [
+            'Get design tokens from a Figma file',
+            'Export components from Figma to React/Vue',
+            'Generate design system tokens (colors, typography, spacing)',
+            'Extract assets and images from Figma frames',
+            'Sync design changes to code automatically'
+        ],
+        troubleshooting: [
+            {
+                issue: 'Authentication failed',
+                solution: 'Verify FIGMA_ACCESS_TOKEN is set and valid. Generate a new token at figma.com/settings with file read permissions.'
+            },
+            {
+                issue: 'File not found',
+                solution: 'Ensure you have access to the Figma file. Check the file URL is correct and you have at least view permissions.'
+            },
+            {
+                issue: 'npx command not found',
+                solution: 'Install Node.js 24+ and ensure npx is available in your PATH.'
+            }
+        ]
+    },
+    // ============================================
+    // VERSION CONTROL
+    // ============================================
+    github: {
+        name: 'github',
+        description: 'Official GitHub MCP server for repository management',
+        category: 'version-control',
+        officialServer: true,
+        config: {
+            name: 'github',
+            transport: {
+                type: 'stdio',
+                command: 'npx',
+                args: ['@modelcontextprotocol/server-github'],
+                env: {}
+            }
+        },
+        requiredEnv: [
+            {
+                name: 'GITHUB_TOKEN',
+                description: 'GitHub personal access token (classic or fine-grained)',
+                url: 'https://github.com/settings/tokens'
+            }
+        ],
+        setupInstructions: `
+1. Create a personal access token at https://github.com/settings/tokens
+2. Grant permissions: repo (all), workflow (if needed)
+3. Set environment variable: export GITHUB_TOKEN="ghp_your_token"
+4. Run: ax-cli mcp add github --template
+5. Test: ax-cli mcp test github
+    `.trim(),
+        usageExamples: [
+            'Create and manage pull requests',
+            'Search and manage issues',
+            'Review code and comments',
+            'Access repository information',
+            'Manage GitHub workflows and actions'
+        ],
+        troubleshooting: [
+            {
+                issue: 'Authentication failed (401)',
+                solution: 'Verify GITHUB_TOKEN is valid and starts with "ghp_" (classic) or "github_pat_" (fine-grained). Regenerate if expired.'
+            },
+            {
+                issue: 'Permission denied',
+                solution: 'Check token has required scopes. For most operations, you need "repo" scope. For workflows, add "workflow" scope.'
+            }
+        ]
+    },
+    // ============================================
+    // DEPLOYMENT PLATFORMS
+    // ============================================
+    vercel: {
+        name: 'vercel',
+        description: 'Vercel MCP server for deployment automation',
+        category: 'deployment',
+        officialServer: false, // Community server
+        config: {
+            name: 'vercel',
+            transport: {
+                type: 'http',
+                url: 'https://api.vercel.com/mcp', // Hypothetical - check if official exists
+                headers: {}
+            }
+        },
+        requiredEnv: [
+            {
+                name: 'VERCEL_TOKEN',
+                description: 'Vercel API token from account settings',
+                url: 'https://vercel.com/account/tokens'
+            }
+        ],
+        setupInstructions: `
+1. Create an API token at https://vercel.com/account/tokens
+2. Set environment variable: export VERCEL_TOKEN="your_token"
+3. Run: ax-cli mcp add vercel --template
+4. Test: ax-cli mcp test vercel
+    `.trim(),
+        usageExamples: [
+            'Deploy projects to Vercel',
+            'Manage deployments and domains',
+            'Configure environment variables',
+            'Monitor deployment status',
+            'Roll back deployments'
+        ],
+        troubleshooting: [
+            {
+                issue: 'Deployment failed',
+                solution: 'Check build logs in Vercel dashboard. Ensure all environment variables are configured correctly.'
+            },
+            {
+                issue: 'Domain configuration error',
+                solution: 'Verify DNS settings are correct. It may take up to 24 hours for DNS changes to propagate.'
+            }
+        ]
+    },
+    netlify: {
+        name: 'netlify',
+        description: 'Netlify MCP server for JAMstack deployments',
+        category: 'deployment',
+        officialServer: false,
+        config: {
+            name: 'netlify',
+            transport: {
+                type: 'http',
+                url: 'https://api.netlify.com/mcp',
+                headers: {}
+            }
+        },
+        requiredEnv: [
+            {
+                name: 'NETLIFY_TOKEN',
+                description: 'Netlify personal access token',
+                url: 'https://app.netlify.com/user/applications'
+            }
+        ],
+        setupInstructions: `
+1. Create a personal access token at https://app.netlify.com/user/applications
+2. Set environment variable: export NETLIFY_TOKEN="your_token"
+3. Run: ax-cli mcp add netlify --template
+4. Test: ax-cli mcp test netlify
+    `.trim(),
+        usageExamples: [
+            'Deploy static sites to Netlify',
+            'Manage forms and serverless functions',
+            'Configure build settings',
+            'Monitor site analytics',
+            'Manage custom domains and SSL'
+        ],
+        troubleshooting: [
+            {
+                issue: 'Build timeout',
+                solution: 'Optimize build process or upgrade to a higher plan with longer build times.'
+            }
+        ]
+    },
+    // ============================================
+    // TESTING & QA
+    // ============================================
+    puppeteer: {
+        name: 'puppeteer',
+        description: 'Puppeteer MCP server for browser automation and testing',
+        category: 'testing',
+        officialServer: false,
+        config: {
+            name: 'puppeteer',
+            transport: {
+                type: 'stdio',
+                command: 'npx',
+                args: ['@modelcontextprotocol/server-puppeteer']
+            }
+        },
+        requiredEnv: [],
+        setupInstructions: `
+1. Ensure Node.js 24+ is installed
+2. Run: ax-cli mcp add puppeteer --template
+3. Test: ax-cli mcp test puppeteer
+
+Note: First run may take longer as Chromium is downloaded.
+    `.trim(),
+        usageExamples: [
+            'Automate browser interactions for testing',
+            'Take screenshots of web pages',
+            'Generate PDFs from web content',
+            'Scrape dynamic web content',
+            'Validate UI workflows and user journeys'
+        ],
+        troubleshooting: [
+            {
+                issue: 'Chromium download failed',
+                solution: 'Check internet connection. Try running "npx puppeteer browsers install chrome" manually.'
+            },
+            {
+                issue: 'Browser launch failed',
+                solution: 'Install required system dependencies. On Linux: apt-get install -y libx11-xcb1 libxcomposite1 libxcursor1'
+            }
+        ]
+    },
+    storybook: {
+        name: 'storybook',
+        description: 'Storybook MCP server for component development and testing',
+        category: 'testing',
+        officialServer: false,
+        config: {
+            name: 'storybook',
+            transport: {
+                type: 'http',
+                url: 'http://localhost:6006/mcp', // Local Storybook instance
+                headers: {}
+            }
+        },
+        requiredEnv: [],
+        setupInstructions: `
+1. Ensure Storybook is running: npm run storybook
+2. Run: ax-cli mcp add storybook --template
+3. Test: ax-cli mcp test storybook
+
+Note: Storybook must be running on port 6006.
+    `.trim(),
+        usageExamples: [
+            'Generate Storybook stories for components',
+            'Test component variants and states',
+            'Document component APIs',
+            'Visual regression testing',
+            'Accessibility testing with Storybook addons'
+        ],
+        troubleshooting: [
+            {
+                issue: 'Connection refused',
+                solution: 'Ensure Storybook is running. Start with "npm run storybook" or "yarn storybook".'
+            },
+            {
+                issue: 'Port conflict',
+                solution: 'Check if port 6006 is in use. Configure Storybook to use a different port if needed.'
+            }
+        ]
+    },
+    chromatic: {
+        name: 'chromatic',
+        description: 'Chromatic MCP server for visual testing',
+        category: 'testing',
+        officialServer: false,
+        config: {
+            name: 'chromatic',
+            transport: {
+                type: 'http',
+                url: 'https://api.chromatic.com/mcp',
+                headers: {}
+            }
+        },
+        requiredEnv: [
+            {
+                name: 'CHROMATIC_PROJECT_TOKEN',
+                description: 'Chromatic project token from project settings',
+                url: 'https://www.chromatic.com/docs/access-tokens'
+            }
+        ],
+        setupInstructions: `
+1. Get project token from Chromatic project settings
+2. Set environment variable: export CHROMATIC_PROJECT_TOKEN="your_token"
+3. Run: ax-cli mcp add chromatic --template
+4. Test: ax-cli mcp test chromatic
+    `.trim(),
+        usageExamples: [
+            'Run visual regression tests',
+            'Capture UI snapshots',
+            'Review visual changes in PRs',
+            'Detect unintended UI changes',
+            'Integrate with CI/CD pipelines'
+        ],
+        troubleshooting: [
+            {
+                issue: 'Build failed',
+                solution: 'Check Storybook builds successfully. Ensure all stories are loading without errors.'
+            }
+        ]
+    },
+    // ============================================
+    // MONITORING & ERROR TRACKING
+    // ============================================
+    sentry: {
+        name: 'sentry',
+        description: 'Sentry MCP server for error tracking and monitoring',
+        category: 'monitoring',
+        officialServer: false,
+        config: {
+            name: 'sentry',
+            transport: {
+                type: 'http',
+                url: 'https://sentry.io/api/0/mcp',
+                headers: {}
+            }
+        },
+        requiredEnv: [
+            {
+                name: 'SENTRY_AUTH_TOKEN',
+                description: 'Sentry authentication token',
+                url: 'https://sentry.io/settings/account/api/auth-tokens/'
+            }
+        ],
+        setupInstructions: `
+1. Create an auth token at https://sentry.io/settings/account/api/auth-tokens/
+2. Grant permissions: project:read, project:write, org:read
+3. Set environment variable: export SENTRY_AUTH_TOKEN="your_token"
+4. Run: ax-cli mcp add sentry --template
+5. Test: ax-cli mcp test sentry
+    `.trim(),
+        usageExamples: [
+            'Query error events and issues',
+            'Analyze error trends and patterns',
+            'Create and update issues',
+            'Manage release tracking',
+            'Monitor application health'
+        ],
+        troubleshooting: [
+            {
+                issue: 'Authentication failed',
+                solution: 'Verify SENTRY_AUTH_TOKEN is valid and has required scopes (project:read, project:write, org:read).'
+            },
+            {
+                issue: 'No data returned',
+                solution: 'Check that your Sentry project has received events. Ensure DSN is configured correctly in your app.'
+            }
+        ]
+    },
+    // ============================================
+    // BACKEND & DATABASE
+    // ============================================
+    supabase: {
+        name: 'supabase',
+        description: 'Supabase MCP server for backend and database operations',
+        category: 'backend',
+        officialServer: false,
+        config: {
+            name: 'supabase',
+            transport: {
+                type: 'http',
+                url: 'https://api.supabase.com/mcp',
+                headers: {}
+            }
+        },
+        requiredEnv: [
+            {
+                name: 'SUPABASE_URL',
+                description: 'Your Supabase project URL',
+                url: 'https://app.supabase.com'
+            },
+            {
+                name: 'SUPABASE_KEY',
+                description: 'Supabase service role key or anon key',
+                url: 'https://app.supabase.com'
+            }
+        ],
+        setupInstructions: `
+1. Get your project URL and API keys from https://app.supabase.com/project/_/settings/api
+2. Set environment variables:
+   export SUPABASE_URL="https://xxxxx.supabase.co"
+   export SUPABASE_KEY="your_service_role_key"
+3. Run: ax-cli mcp add supabase --template
+4. Test: ax-cli mcp test supabase
+    `.trim(),
+        usageExamples: [
+            'Query and manage database tables',
+            'Execute SQL queries',
+            'Manage authentication and users',
+            'Work with storage buckets',
+            'Invoke Edge Functions'
+        ],
+        troubleshooting: [
+            {
+                issue: 'Connection failed',
+                solution: 'Verify SUPABASE_URL is correct and includes the https:// protocol. Check project is not paused.'
+            },
+            {
+                issue: 'Permission denied',
+                solution: 'Ensure you are using the service_role key for admin operations, not the anon key.'
+            }
+        ]
+    },
+    firebase: {
+        name: 'firebase',
+        description: 'Firebase MCP server for backend services',
+        category: 'backend',
+        officialServer: false,
+        config: {
+            name: 'firebase',
+            transport: {
+                type: 'http',
+                url: 'https://firebase.googleapis.com/mcp',
+                headers: {}
+            }
+        },
+        requiredEnv: [
+            {
+                name: 'FIREBASE_TOKEN',
+                description: 'Firebase service account token',
+                url: 'https://console.firebase.google.com'
+            }
+        ],
+        setupInstructions: `
+1. Create a service account at https://console.firebase.google.com/project/_/settings/serviceaccounts
+2. Download the service account JSON file
+3. Set environment variable: export FIREBASE_TOKEN="path/to/serviceAccountKey.json"
+4. Run: ax-cli mcp add firebase --template
+5. Test: ax-cli mcp test firebase
+    `.trim(),
+        usageExamples: [
+            'Deploy Firebase Functions',
+            'Manage Firestore database',
+            'Configure Firebase Hosting',
+            'Work with Firebase Authentication',
+            'Monitor Firebase project'
+        ],
+        troubleshooting: [
+            {
+                issue: 'Service account error',
+                solution: 'Verify service account JSON is valid and has required permissions. Ensure file path is correct.'
+            }
+        ]
+    },
+    postgres: {
+        name: 'postgres',
+        description: 'PostgreSQL MCP server for database operations',
+        category: 'backend',
+        officialServer: true,
+        config: {
+            name: 'postgres',
+            transport: {
+                type: 'stdio',
+                command: 'npx',
+                args: ['@modelcontextprotocol/server-postgres'],
+                env: {}
+            }
+        },
+        requiredEnv: [
+            {
+                name: 'DATABASE_URL',
+                description: 'PostgreSQL connection string',
+                url: 'https://www.postgresql.org/docs/current/libpq-connect.html#LIBPQ-CONNSTRING'
+            }
+        ],
+        setupInstructions: `
+1. Get your PostgreSQL connection string (format: postgresql://user:password@host:port/database)
+2. Set environment variable: export DATABASE_URL="postgresql://..."
+3. Run: ax-cli mcp add postgres --template
+4. Test: ax-cli mcp test postgres
+    `.trim(),
+        usageExamples: [
+            'Execute SQL queries',
+            'Inspect database schema',
+            'Manage tables and indexes',
+            'Run migrations',
+            'Analyze query performance'
+        ],
+        troubleshooting: [
+            {
+                issue: 'Connection failed',
+                solution: 'Verify DATABASE_URL is correct. Check PostgreSQL is running and accessible. Ensure firewall allows connection.'
+            },
+            {
+                issue: 'SSL required',
+                solution: 'Add "?sslmode=require" to connection string if database requires SSL.'
+            }
+        ]
+    },
+    sqlite: {
+        name: 'sqlite',
+        description: 'SQLite MCP server for file-based database',
+        category: 'backend',
+        officialServer: true,
+        config: {
+            name: 'sqlite',
+            transport: {
+                type: 'stdio',
+                command: 'npx',
+                args: ['@modelcontextprotocol/server-sqlite'],
+                env: {}
+            }
+        },
+        requiredEnv: [
+            {
+                name: 'DATABASE_PATH',
+                description: 'Path to SQLite database file',
+                url: 'https://www.sqlite.org/docs.html'
+            }
+        ],
+        setupInstructions: `
+1. Locate your SQLite database file or create a new one
+2. Set environment variable: export DATABASE_PATH="/path/to/database.db"
+3. Run: ax-cli mcp add sqlite --template
+4. Test: ax-cli mcp test sqlite
+    `.trim(),
+        usageExamples: [
+            'Query local SQLite databases',
+            'Inspect database schema',
+            'Manage data in local development',
+            'Lightweight data storage',
+            'Testing and prototyping'
+        ],
+        troubleshooting: [
+            {
+                issue: 'File not found',
+                solution: 'Verify DATABASE_PATH points to existing file. SQLite will create the file if it does not exist.'
+            },
+            {
+                issue: 'Permission denied',
+                solution: 'Check file permissions. Ensure the process has read/write access to the database file.'
+            }
+        ]
+    }
+};
+/**
+ * Get all available template names
+ */
+export function getTemplateNames() {
+    return Object.keys(TEMPLATES).sort();
+}
+/**
+ * Get template by name
+ */
+export function getTemplate(name) {
+    return TEMPLATES[name.toLowerCase()];
+}
+/**
+ * Get templates by category
+ */
+export function getTemplatesByCategory(category) {
+    return Object.values(TEMPLATES).filter(t => t.category === category);
+}
+/**
+ * Search templates by keyword
+ */
+export function searchTemplates(query) {
+    const lowerQuery = query.toLowerCase();
+    return Object.values(TEMPLATES).filter(template => template.name.toLowerCase().includes(lowerQuery) ||
+        template.description.toLowerCase().includes(lowerQuery) ||
+        template.usageExamples.some(ex => ex.toLowerCase().includes(lowerQuery)));
+}
+/**
+ * Check if a template exists
+ */
+export function hasTemplate(name) {
+    return name.toLowerCase() in TEMPLATES;
+}
+/**
+ * Generate MCP config from template with environment variables
+ */
+export function generateConfigFromTemplate(templateName, envVars) {
+    const template = getTemplate(templateName);
+    if (!template) {
+        throw new Error(`Template "${templateName}" not found`);
+    }
+    // Clone the config to avoid mutating the template
+    const config = JSON.parse(JSON.stringify(template.config));
+    // Inject environment variables
+    if (config.transport.env) {
+        config.transport.env = { ...config.transport.env, ...envVars };
+    }
+    else {
+        config.transport.env = envVars;
+    }
+    // For HTTP/SSE transports, inject auth headers if needed
+    if ((config.transport.type === 'http' || config.transport.type === 'sse') && config.transport.headers) {
+        // Inject authorization tokens into headers if specified
+        const headers = { ...config.transport.headers };
+        // Common patterns
+        if (envVars.GITHUB_TOKEN) {
+            headers['Authorization'] = `Bearer ${envVars.GITHUB_TOKEN}`;
+        }
+        if (envVars.VERCEL_TOKEN) {
+            headers['Authorization'] = `Bearer ${envVars.VERCEL_TOKEN}`;
+        }
+        if (envVars.NETLIFY_TOKEN) {
+            headers['Authorization'] = `Bearer ${envVars.NETLIFY_TOKEN}`;
+        }
+        if (envVars.SENTRY_AUTH_TOKEN) {
+            headers['Authorization'] = `Bearer ${envVars.SENTRY_AUTH_TOKEN}`;
+        }
+        config.transport.headers = headers;
+    }
+    return config;
+}
+//# sourceMappingURL=templates.js.map

package/dist/mcp/templates.js.map

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

package/dist/mcp/validation.d.ts

@@ -0,0 +1,25 @@
+/**
+ * MCP Server Configuration Validation (Phase 4)
+ *
+ * Provides pre-flight checks to validate MCP server configurations
+ * before attempting connection, improving error messages and UX.
+ */
+import type { MCPServerConfig } from '../schemas/settings-schemas.js';
+export interface ValidationResult {
+    valid: boolean;
+    warnings: string[];
+    errors: string[];
+}
+export interface ValidationIssue {
+    type: 'error' | 'warning';
+    message: string;
+    field?: string;
+}
+/**
+ * Validate an MCP server configuration with pre-flight checks
+ */
+export declare function validateServerConfig(config: MCPServerConfig): Promise<ValidationResult>;
+/**
+ * Format validation result for display
+ */
+export declare function formatValidationResult(result: ValidationResult): string;