ebay-mcp-remote-edition 1.0.0

package/build/scripts/auto-setup.js

@@ -0,0 +1,364 @@
+/**
+ * Auto-Setup Script for eBay API MCP Server
+ *
+ * This script automatically:
+ * 1. Detects installed MCP clients (Claude Desktop, Gemini, ChatGPT)
+ * 2. Generates MCP client configurations from .env
+ * 3. Validates environment tokens configuration
+ * 4. Validates the setup
+ *
+ * Usage: npm run auto-setup (or runs automatically after npm install)
+ */
+import { dirname, join } from 'path';
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'fs';
+import { homedir, platform } from 'os';
+import { config } from 'dotenv';
+import { fileURLToPath } from 'url';
+// Load environment variables silently
+config({ quiet: true });
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const PROJECT_ROOT = join(__dirname, '../..');
+// ═══════════════════════════════════════════════════════════════════════════
+// Color Utilities
+// ═══════════════════════════════════════════════════════════════════════════
+const colors = {
+    reset: '\x1b[0m',
+    red: '\x1b[31m',
+    green: '\x1b[32m',
+    yellow: '\x1b[33m',
+    blue: '\x1b[34m',
+    cyan: '\x1b[36m',
+};
+function print(message, color) {
+    const colorCode = color ? colors[color] : '';
+    console.log(`${colorCode}${message}${colors.reset}`);
+}
+function printSuccess(message) {
+    print(`✅ ${message}`, 'green');
+}
+function printWarning(message) {
+    print(`⚠️  ${message}`, 'yellow');
+}
+function printError(message) {
+    print(`❌ ${message}`, 'red');
+}
+function printInfo(message) {
+    print(`ℹ️  ${message}`, 'cyan');
+}
+function printHeader(message) {
+    print('\n═══════════════════════════════════════════════════════════════════════════', 'blue');
+    print(`  ${message}`, 'cyan');
+    print('═══════════════════════════════════════════════════════════════════════════\n', 'blue');
+}
+function getConfigPaths() {
+    const home = homedir();
+    const os = platform();
+    const paths = {};
+    // Claude Desktop config paths
+    if (os === 'darwin') {
+        paths.claude = join(home, 'Library/Application Support/Claude/claude_desktop_config.json');
+    }
+    else if (os === 'win32') {
+        paths.claude = join(home, 'AppData/Roaming/Claude/claude_desktop_config.json');
+    }
+    else {
+        paths.claude = join(home, '.config/Claude/claude_desktop_config.json');
+    }
+    // Cline (VSCode Extension) config paths
+    if (os === 'darwin') {
+        paths.cline = join(home, 'Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json');
+    }
+    else if (os === 'win32') {
+        paths.cline = join(home, 'AppData/Roaming/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json');
+    }
+    else {
+        paths.cline = join(home, '.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json');
+    }
+    // Continue.dev config path
+    paths.continue = join(home, '.continue/config.json');
+    // Zed editor config paths
+    if (os === 'darwin') {
+        paths.zed = join(home, '.config/zed/settings.json');
+    }
+    else if (os === 'win32') {
+        paths.zed = join(home, 'AppData/Roaming/Zed/settings.json');
+    }
+    else {
+        paths.zed = join(home, '.config/zed/settings.json');
+    }
+    // Cursor IDE config path
+    paths.cursor = join(home, '.cursor/mcp.json');
+    // Windsurf (Codeium) config path
+    paths.windsurf = join(home, '.codeium/windsurf/mcp_config.json');
+    // Roo Code (VSCode Extension) config paths
+    if (os === 'darwin') {
+        paths.roocode = join(home, 'Library/Application Support/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/mcp_settings.json');
+    }
+    else if (os === 'win32') {
+        paths.roocode = join(home, 'AppData/Roaming/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/mcp_settings.json');
+    }
+    else {
+        paths.roocode = join(home, '.config/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/mcp_settings.json');
+    }
+    // Claude Code CLI config path
+    paths.claudecode = join(home, '.claude.json');
+    // Amazon Q Developer config path
+    paths.amazonq = join(home, '.aws/amazonq/mcp.json');
+    return paths;
+}
+function detectMCPClients() {
+    const configPaths = getConfigPaths();
+    const clients = [];
+    for (const [name, configPath] of Object.entries(configPaths)) {
+        const detected = existsSync(configPath) || existsSync(dirname(configPath));
+        clients.push({
+            name,
+            configPath,
+            detected,
+        });
+    }
+    return clients;
+}
+function generateMCPServerConfig() {
+    const buildPath = join(PROJECT_ROOT, 'build/index.js');
+    const config = {
+        command: 'node',
+        args: [buildPath],
+        env: {
+            EBAY_CLIENT_ID: process.env.EBAY_CLIENT_ID || '',
+            EBAY_CLIENT_SECRET: process.env.EBAY_CLIENT_SECRET || '',
+            EBAY_ENVIRONMENT: process.env.EBAY_ENVIRONMENT || 'sandbox',
+        },
+    };
+    // Add optional environment variables if they exist
+    if (process.env.EBAY_REDIRECT_URI) {
+        config.env.EBAY_REDIRECT_URI = process.env.EBAY_REDIRECT_URI;
+    }
+    if (process.env.EBAY_MARKETPLACE_ID) {
+        config.env.EBAY_MARKETPLACE_ID = process.env.EBAY_MARKETPLACE_ID;
+    }
+    if (process.env.EBAY_CONTENT_LANGUAGE) {
+        config.env.EBAY_CONTENT_LANGUAGE = process.env.EBAY_CONTENT_LANGUAGE;
+    }
+    if (process.env.EBAY_USER_ACCESS_TOKEN) {
+        config.env.EBAY_USER_ACCESS_TOKEN = process.env.EBAY_USER_ACCESS_TOKEN;
+    }
+    if (process.env.EBAY_USER_REFRESH_TOKEN) {
+        config.env.EBAY_USER_REFRESH_TOKEN = process.env.EBAY_USER_REFRESH_TOKEN;
+    }
+    if (process.env.EBAY_APP_ACCESS_TOKEN) {
+        config.env.EBAY_APP_ACCESS_TOKEN = process.env.EBAY_APP_ACCESS_TOKEN;
+    }
+    return config;
+}
+function updateClientConfig(client, serverConfig) {
+    try {
+        // Ensure directory exists
+        const configDir = dirname(client.configPath);
+        if (!existsSync(configDir)) {
+            mkdirSync(configDir, { recursive: true });
+        }
+        // Read existing config or create new one
+        let config = {};
+        if (existsSync(client.configPath)) {
+            try {
+                const existing = readFileSync(client.configPath, 'utf-8');
+                config = JSON.parse(existing);
+            }
+            catch (_error) {
+                printWarning(`Invalid JSON in ${client.configPath}, creating backup and new config`);
+                const backup = `${client.configPath}.backup.${Date.now()}`;
+                writeFileSync(backup, readFileSync(client.configPath));
+                printInfo(`Backup saved to: ${backup}`);
+                config = {};
+            }
+        }
+        // Handle different config formats for different clients
+        switch (client.name) {
+            case 'zed': {
+                // Zed uses context_servers with a different structure
+                if (!config.context_servers || typeof config.context_servers !== 'object') {
+                    config.context_servers = {};
+                }
+                const contextServers = config.context_servers;
+                contextServers['ebay-mcp-server'] = {
+                    command: {
+                        path: serverConfig.command,
+                        args: serverConfig.args,
+                        env: serverConfig.env,
+                    },
+                    settings: {},
+                };
+                break;
+            }
+            case 'continue': {
+                // Continue.dev uses experimental.modelContextProtocolServers as an array
+                if (!config.experimental || typeof config.experimental !== 'object') {
+                    config.experimental = {};
+                }
+                const experimental = config.experimental;
+                if (!experimental.modelContextProtocolServers ||
+                    !Array.isArray(experimental.modelContextProtocolServers)) {
+                    experimental.modelContextProtocolServers = [];
+                }
+                const mcpServers = experimental.modelContextProtocolServers;
+                // Check if eBay server already exists and update/add
+                const existingIndex = mcpServers.findIndex((server) => server.command === 'node' && server.args?.[0]?.includes('ebay-mcp-remote-edition'));
+                if (existingIndex >= 0) {
+                    mcpServers[existingIndex] = serverConfig;
+                }
+                else {
+                    mcpServers.push(serverConfig);
+                }
+                break;
+            }
+            default: {
+                // Standard mcpServers format for Claude Desktop, Cline, Cursor, Windsurf, Roo Code, Claude Code CLI, Amazon Q
+                if (!config.mcpServers || typeof config.mcpServers !== 'object') {
+                    config.mcpServers = {};
+                }
+                const mcpServers = config.mcpServers;
+                mcpServers['ebay-mcp-server'] = serverConfig;
+                break;
+            }
+        }
+        // Write config
+        writeFileSync(client.configPath, JSON.stringify(config, null, 2));
+        return true;
+    }
+    catch (error) {
+        printError(`Failed to update ${client.name} config: ${error}`);
+        return false;
+    }
+}
+// ═══════════════════════════════════════════════════════════════════════════
+// Token Validation (Environment-based only)
+// ═══════════════════════════════════════════════════════════════════════════
+function validateTokens() {
+    // Check if user refresh token is provided in .env
+    const hasUserRefreshToken = process.env.EBAY_USER_REFRESH_TOKEN;
+    if (!hasUserRefreshToken) {
+        printInfo('No EBAY_USER_REFRESH_TOKEN in .env - will use app tokens (1k req/day)');
+        printInfo('For higher rate limits (10k-50k req/day), add EBAY_USER_REFRESH_TOKEN to .env');
+        return true; // Not an error, just informational
+    }
+    printSuccess('User refresh token found in .env - high rate limits enabled');
+    return true;
+}
+// ═══════════════════════════════════════════════════════════════════════════
+// Validation
+// ═══════════════════════════════════════════════════════════════════════════
+function validateEnvironment() {
+    const errors = [];
+    const warnings = [];
+    // Check .env file exists
+    const envPath = join(PROJECT_ROOT, '.env');
+    if (!existsSync(envPath)) {
+        errors.push('.env file not found. Copy .env.example to .env and fill in your credentials.');
+        return { valid: false, errors, warnings };
+    }
+    // Check required variables
+    if (!process.env.EBAY_CLIENT_ID) {
+        errors.push('EBAY_CLIENT_ID is not set in .env');
+    }
+    if (!process.env.EBAY_CLIENT_SECRET) {
+        errors.push('EBAY_CLIENT_SECRET is not set in .env');
+    }
+    const environment = process.env.EBAY_ENVIRONMENT;
+    if (environment && environment !== 'production' && environment !== 'sandbox') {
+        errors.push(`EBAY_ENVIRONMENT must be "production" or "sandbox", got: "${environment}"`);
+    }
+    if (!process.env.EBAY_REDIRECT_URI) {
+        warnings.push('EBAY_REDIRECT_URI is not set - user OAuth flow will not work. This is required for 10k-50k req/day rate limits.');
+    }
+    // Check build directory exists
+    const buildPath = join(PROJECT_ROOT, 'build/index.js');
+    if (!existsSync(buildPath)) {
+        warnings.push('Build directory not found. Run "npm run build" first.');
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+        warnings,
+    };
+}
+// ═══════════════════════════════════════════════════════════════════════════
+// Main
+// ═══════════════════════════════════════════════════════════════════════════
+// eslint-disable-next-line @typescript-eslint/require-await
+async function main() {
+    printHeader('eBay API MCP Server - Auto Setup');
+    // Step 1: Validate environment
+    printInfo('Step 1/4: Validating environment configuration...');
+    const validation = validateEnvironment();
+    if (validation.errors.length > 0) {
+        printError('Environment validation failed:');
+        validation.errors.forEach((error) => print(`  • ${error}`, 'red'));
+        print('\nPlease fix these errors and run again.', 'yellow');
+        process.exit(1);
+    }
+    if (validation.warnings.length > 0) {
+        validation.warnings.forEach((warning) => printWarning(warning));
+    }
+    printSuccess('Environment validation passed');
+    // Step 2: Detect MCP clients
+    print('\nStep 2/4: Detecting installed MCP clients...');
+    const clients = detectMCPClients();
+    const detectedClients = clients.filter((c) => c.detected);
+    if (detectedClients.length === 0) {
+        printWarning('No MCP clients detected on this system');
+        printInfo('Supported clients: Claude Desktop, Cline, Continue.dev, Zed, Cursor, Windsurf, Roo Code, Claude Code CLI, Amazon Q');
+        printInfo('Install a client and run this script again');
+    }
+    else {
+        printSuccess(`Detected ${detectedClients.length} MCP client(s):`);
+        detectedClients.forEach((client) => {
+            print(`  • ${client.name.charAt(0).toUpperCase() + client.name.slice(1)}`, 'green');
+        });
+    }
+    // Step 3: Generate configurations
+    if (detectedClients.length > 0) {
+        print('\nStep 3/4: Generating MCP client configurations...');
+        const serverConfig = generateMCPServerConfig();
+        for (const client of detectedClients) {
+            const success = updateClientConfig(client, serverConfig);
+            if (success) {
+                printSuccess(`Generated config for ${client.name} at: ${client.configPath}`);
+                client.configGenerated = true;
+            }
+        }
+    }
+    else {
+        print('\nStep 3/4: Skipping config generation (no clients detected)');
+    }
+    // Step 4: Validate tokens
+    print('\nStep 4/4: Validating token configuration...');
+    validateTokens();
+    // Final summary
+    printHeader('Setup Complete! 🎉');
+    const generatedCount = detectedClients.filter((c) => c.configGenerated).length;
+    if (generatedCount > 0) {
+        printSuccess(`Successfully configured ${generatedCount} MCP client(s)`);
+        print('\n📝 Next Steps:', 'cyan');
+        print('  1. Restart your MCP clients (Claude Desktop, Cursor, Zed, etc.)');
+        print('  2. Verify connection in MCP client settings/logs');
+        print('  3. Test with: "List my eBay inventory items"');
+        if (validation.warnings.some((w) => w.includes('EBAY_REDIRECT_URI'))) {
+            print('\n💡 Pro Tip:', 'yellow');
+            print('  Add EBAY_REDIRECT_URI to .env for user OAuth (10k-50k req/day rate limits)');
+        }
+    }
+    else {
+        printInfo('No configurations generated (no MCP clients detected)');
+        print('\n📝 To complete setup:', 'cyan');
+        print('  1. Install an MCP client (Claude Desktop, Cline, Cursor, Zed, Windsurf, Continue.dev, Roo Code, Claude Code CLI, or Amazon Q)');
+        print('  2. Run: npm run auto-setup');
+    }
+    print('\n📚 Documentation: https://github.com/mrnajiboy/ebay-mcp-remote-edition#readme\n');
+}
+// Run the script
+main().catch((error) => {
+    printError(`Auto-setup failed: ${error}`);
+    process.exit(1);
+});