@nordsym/apiclaw 1.3.8 → 1.3.9

package/src/cli/commands/mcp-install.ts

@@ -0,0 +1,291 @@
+/**
+ * MCP Install Command
+ * Simple, focused command to install APIClaw into MCP config files
+ * Supports Claude Desktop and Claude Code
+ */
+
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'fs';
+import { dirname, join } from 'path';
+import { platform, homedir } from 'os';
+import chalk from 'chalk';
+
+export interface MCPInstallOptions {
+  client?: string;
+  dryRun?: boolean;
+}
+
+type Platform = 'mac' | 'win' | 'linux';
+
+interface ClientConfig {
+  name: string;
+  displayName: string;
+  getConfigPath: () => string;
+  configKey: string; // Key path in config (e.g., "mcpServers" or root level)
+}
+
+/**
+ * Detect operating system
+ */
+function detectOS(): Platform {
+  const os = platform();
+  switch (os) {
+    case 'darwin': return 'mac';
+    case 'win32': return 'win';
+    default: return 'linux';
+  }
+}
+
+/**
+ * Get home directory
+ */
+function getHome(): string {
+  return homedir();
+}
+
+/**
+ * Get config paths for supported clients
+ */
+function getClientConfigs(): ClientConfig[] {
+  const os = detectOS();
+  const home = getHome();
+  
+  const clients: ClientConfig[] = [
+    {
+      name: 'claude-desktop',
+      displayName: 'Claude Desktop',
+      configKey: 'mcpServers',
+      getConfigPath: () => {
+        switch (os) {
+          case 'mac':
+            return join(home, 'Library', 'Application Support', 'Claude', 'claude_desktop_config.json');
+          case 'win':
+            return join(process.env.APPDATA || join(home, 'AppData', 'Roaming'), 'Claude', 'claude_desktop_config.json');
+          case 'linux':
+            return join(home, '.config', 'Claude', 'claude_desktop_config.json');
+        }
+      },
+    },
+    {
+      name: 'claude-code',
+      displayName: 'Claude Code',
+      configKey: 'mcpServers',
+      getConfigPath: () => {
+        // Claude Code uses ~/.claude.json on all platforms
+        return join(home, '.claude.json');
+      },
+    },
+  ];
+  
+  return clients;
+}
+
+/**
+ * APIClaw MCP server configuration
+ */
+const APICLAW_CONFIG = {
+  command: 'npx',
+  args: ['-y', '@nordsym/apiclaw', 'serve'],
+};
+
+/**
+ * Read JSON config file
+ */
+function readConfig(path: string): { success: boolean; config: any; error?: string; isNew?: boolean } {
+  try {
+    if (!existsSync(path)) {
+      return { success: true, config: {}, isNew: true };
+    }
+    
+    const content = readFileSync(path, 'utf-8');
+    if (!content.trim()) {
+      return { success: true, config: {}, isNew: true };
+    }
+    
+    return { success: true, config: JSON.parse(content), isNew: false };
+  } catch (error) {
+    return { 
+      success: false, 
+      config: null, 
+      error: error instanceof Error ? error.message : 'Unknown error' 
+    };
+  }
+}
+
+/**
+ * Write JSON config file with backup
+ */
+function writeConfig(path: string, config: any, createBackup = true): { success: boolean; error?: string } {
+  try {
+    const dir = dirname(path);
+    if (!existsSync(dir)) {
+      mkdirSync(dir, { recursive: true });
+    }
+    
+    // Create backup if file exists
+    if (createBackup && existsSync(path)) {
+      const backupPath = `${path}.backup.${Date.now()}.json`;
+      const existing = readFileSync(path, 'utf-8');
+      writeFileSync(backupPath, existing, 'utf-8');
+    }
+    
+    writeFileSync(path, JSON.stringify(config, null, 2), 'utf-8');
+    return { success: true };
+  } catch (error) {
+    return { 
+      success: false, 
+      error: error instanceof Error ? error.message : 'Unknown error' 
+    };
+  }
+}
+
+/**
+ * Install APIClaw into a client config
+ */
+function installToClient(client: ClientConfig, dryRun: boolean): { success: boolean; message: string; skipped?: boolean } {
+  const configPath = client.getConfigPath();
+  
+  // Read existing config
+  const readResult = readConfig(configPath);
+  if (!readResult.success) {
+    return { success: false, message: `Failed to read config: ${readResult.error}` };
+  }
+  
+  const config = readResult.config;
+  
+  // Initialize mcpServers if not present
+  if (!config.mcpServers) {
+    config.mcpServers = {};
+  }
+  
+  // Check if already installed
+  if (config.mcpServers.apiclaw) {
+    return { success: true, message: 'Already installed', skipped: true };
+  }
+  
+  // Add APIClaw config
+  config.mcpServers.apiclaw = APICLAW_CONFIG;
+  
+  if (dryRun) {
+    console.log(chalk.cyan(`\n  Would add to ${configPath}:`));
+    console.log(chalk.gray(JSON.stringify({ apiclaw: APICLAW_CONFIG }, null, 4)));
+    return { success: true, message: 'Dry run - no changes made', skipped: true };
+  }
+  
+  // Write config
+  const writeResult = writeConfig(configPath, config);
+  if (!writeResult.success) {
+    return { success: false, message: `Failed to write config: ${writeResult.error}` };
+  }
+  
+  return { 
+    success: true, 
+    message: readResult.isNew ? 'Created new config' : 'Updated config' 
+  };
+}
+
+/**
+ * Main mcp-install command handler
+ */
+export async function mcpInstallCommand(options: MCPInstallOptions): Promise<void> {
+  const os = detectOS();
+  const osName = os === 'mac' ? 'macOS' : os === 'win' ? 'Windows' : 'Linux';
+  
+  console.log(chalk.bold('\n🦞 APIClaw MCP Install\n'));
+  console.log(`Platform: ${osName}\n`);
+  
+  const clients = getClientConfigs();
+  let targetClients = clients;
+  
+  // Filter to specific client if requested
+  if (options.client) {
+    const normalizedClient = options.client.toLowerCase().replace(/[_\s]/g, '-');
+    const aliases: Record<string, string> = {
+      'claude': 'claude-desktop',
+      'claude-desktop': 'claude-desktop',
+      'claudedesktop': 'claude-desktop',
+      'desktop': 'claude-desktop',
+      'code': 'claude-code',
+      'claude-code': 'claude-code',
+      'claudecode': 'claude-code',
+    };
+    
+    const targetName = aliases[normalizedClient];
+    if (!targetName) {
+      console.log(chalk.red(`❌ Unknown client: ${options.client}`));
+      console.log('   Supported: claude-desktop, claude-code');
+      process.exit(1);
+    }
+    
+    targetClients = clients.filter(c => c.name === targetName);
+  }
+  
+  // Detect which clients exist
+  console.log('🔍 Detecting MCP clients...\n');
+  
+  const detectedClients: ClientConfig[] = [];
+  for (const client of targetClients) {
+    const configPath = client.getConfigPath();
+    const configDir = dirname(configPath);
+    const exists = existsSync(configPath) || existsSync(configDir);
+    
+    const icon = exists ? chalk.green('✓') : chalk.gray('✗');
+    const status = exists ? 'found' : 'not found';
+    console.log(`   ${icon} ${client.displayName} ${status}`);
+    
+    if (exists) {
+      detectedClients.push(client);
+    }
+  }
+  
+  console.log('');
+  
+  if (detectedClients.length === 0) {
+    console.log(chalk.yellow('⚠️  No MCP clients detected.'));
+    console.log('   Install Claude Desktop or Claude Code first.\n');
+    process.exit(0);
+  }
+  
+  // Install to each detected client
+  let successCount = 0;
+  let skipCount = 0;
+  let failCount = 0;
+  
+  for (const client of detectedClients) {
+    const result = installToClient(client, options.dryRun || false);
+    
+    if (result.success) {
+      if (result.skipped) {
+        skipCount++;
+        console.log(chalk.yellow(`⏭️  ${client.displayName}: ${result.message}`));
+      } else {
+        successCount++;
+        console.log(chalk.green(`✓ ${client.displayName}: ${result.message}`));
+      }
+    } else {
+      failCount++;
+      console.log(chalk.red(`✗ ${client.displayName}: ${result.message}`));
+    }
+  }
+  
+  // Summary
+  console.log('\n' + '═'.repeat(50));
+  
+  if (failCount === 0) {
+    if (options.dryRun) {
+      console.log(chalk.cyan('\n✅ Dry run complete! Run without --dry-run to apply changes.\n'));
+    } else if (successCount > 0) {
+      console.log(chalk.green('\n✅ APIClaw installed successfully!\n'));
+      console.log('Next steps:');
+      console.log('  1. Restart your MCP client (Claude Desktop/Code)');
+      console.log('  2. Ask: "List available APIs"');
+      console.log('');
+      console.log('Need help? https://apiclaw.com/docs\n');
+    } else {
+      console.log(chalk.yellow('\n✅ APIClaw already installed in all clients.\n'));
+      console.log('Run with --force to reinstall (coming soon).\n');
+    }
+  } else {
+    console.log(chalk.red(`\n⚠️  Installation completed with ${failCount} error(s).\n`));
+    process.exit(1);
+  }
+}

package/src/cli/index.ts

@@ -7,6 +7,7 @@
 import { Command } from 'commander';
 import { writeFileSync } from 'fs';
 import { setupCommand } from './commands/setup.js';
+import { mcpInstallCommand } from './commands/mcp-install.js';
 import { doctorCommand } from './commands/doctor.js';
 import { restoreCommand } from './commands/restore.js';
 import { uninstallCommand } from './commands/uninstall.js';
@@ -68,6 +69,14 @@ program
     await setupCommand(options);
   });
 
+// MCP Install command - simple focused installation
+program
+  .command('mcp-install')
+  .description('Install APIClaw into Claude Desktop or Claude Code MCP config')
+  .option('-c, --client <client>', 'Target specific client (claude-desktop, claude-code)')
+  .option('--dry-run', 'Show what would happen without making changes')
+  .action(mcpInstallCommand);
+
 // Doctor command - health check
 program
   .command('doctor')

package/STATUS.md

@@ -1,160 +0,0 @@
-# APIClaw Status — Verifierad 26 Feb 2026, 18:50 CET
-
-> **Denna fil är source of truth.** Uppdatera vid varje deploy/ändring.
-
----
-
-## 🚀 SENASTE NYTT
-
-### Launch Meeting (26 feb 2026)
-- **Pitch till Ismael från Launch** — gick bra!
-- **Live demo fungerade perfekt:**
-  - Skapade NordSym Echo API live i browsern
-  - Konfigurerade Direct Call med Vercel endpoint
-  - Whisper-transkribering via Replicate bevisade proxy-konceptet
-- **Key reactions:**
-  - "Wow" när vi visade tillväxt från 1,400 → 16,000 APIs
-  - Ismael log när Gustav sa "building for agents"
-  - Enades om att "API is the missing piece" för agenter
-- **Mötet filmades** — demo med Symbot dokumenterad
-- **Väntar på respons nästa vecka**
-
----
-
-## 📊 Snabbstatus
-
-| Komponent | Status | Detaljer |
-|-----------|--------|----------|
-| **npm** | ✅ Live | `@nordsym/apiclaw` |
-| **Landing** | ✅ Live | https://apiclaw.nordsym.com |
-| **Convex** | ✅ Deployat | `adventurous-avocet-799` |
-| **API Registry** | ✅ 5,616 | Live-data från landing |
-| **Direct Call** | ✅ 11 providers | Replicate, OpenRouter, ElevenLabs, m.fl. |
-| **Provider Dashboard** | ✅ Live | Self-service onboarding fungerar |
-
----
-
-## ⚡ Direct Call Providers (11 st)
-
-| Provider | Capability | Status |
-|----------|-----------|--------|
-| Replicate | Whisper, Stable Diffusion, 1000+ ML models | ✅ Live |
-| OpenRouter | GPT-4, Claude, Llama, 100+ LLMs | ✅ Live |
-| ElevenLabs | Text-to-speech i 29 språk | ✅ Live |
-| 46elks | SMS i Sverige och globalt | ✅ Live |
-| Twilio | Enterprise SMS och voice | ✅ Live |
-| Resend | Modern email API | ✅ Live |
-| Brave Search | Privacy-focused web search | ✅ Live |
-| Firecrawl | Web scraping till LLM-ready markdown | ✅ Live |
-| E2B | Secure cloud sandboxes för kod | ✅ Live |
-| GitHub | Repos, issues, PRs | ✅ Live |
-| CoinGecko | Crypto priser och market data | ✅ Live |
-
----
-
-## 🎯 Pitch Points (för samtal med investerare/partners)
-
-**One-liner:** "The API layer for AI agents"
-
-**Problem:**
-- Agenter har inget ställe att hitta, jämföra och utvärdera API:er
-- Providers kan inte nå agenter snabbt nog — allt gammalt är byggt för människor
-
-**Solution:**
-- MCP server som ger agenter instant access till API-lagret
-- 5,600+ APIs indexerade för discovery
-- Direct Call — vi proxar requests så agenter slipper hantera API-nycklar
-
-**Traction:**
-- 16,980 APIs indexerade
-- 865 open APIs
-- 11 Direct Call providers
-- 2 partnerships signerade (46elks, CoAccept)
-
-**Business model:**
-- Free discovery
-- Direct Call är pay-per-use — vi tar marginal på proxade requests
-
----
-
-## 🔧 Provider Dashboard
-
-**URL:** https://apiclaw.nordsym.com/providers/dashboard
-
-**Fungerar:**
-- Email magic link login
-- Skapa provider-konto
-- Lista nya API:er (4-stegs wizard)
-- Konfigurera Direct Call (base URL, auth, rate limits)
-- Se analytics (preview)
-
-**Demo-flow (bevisat live):**
-1. Logga in som NordSym AB
-2. Klicka "Add API"
-3. Fyll i namn, beskrivning, kategori, pricing
-4. Submit → "You're Listed!"
-5. Gå till Direct Call tab
-6. Konfigurera endpoint + auth
-7. Sätt status till Live
-8. Verifiera med curl
-
----
-
-## 📁 Projektstruktur
-
-```
-apiclaw/
-├── src/                    # MCP Server (TypeScript)
-│   ├── index.ts            # Huvudfil, MCP tool definitions
-│   ├── discovery.ts        # Söklogik
-│   ├── execute.ts          # Direct Call handlers
-│   └── registry/
-│       └── apis.json       # API registry
-│
-├── landing/                # Next.js frontend
-│   └── src/app/
-│       ├── page.tsx        # Homepage
-│       ├── providers/      # Provider-portal
-│       └── admin/          # Admin-panel
-│
-├── convex/                 # Backend
-│   ├── schema.ts           # Databasschema
-│   ├── providers.ts        # Provider CRUD
-│   └── credits.ts          # Credits
-│
-├── dist/                   # Kompilerad JS
-└── STATUS.md               # DENNA FIL
-```
-
----
-
-## 📈 Roadmap
-
-**Nu (Q1 2026):**
-- ✅ 16k+ APIs
-- ✅ Direct Call fungerar
-- ✅ Provider self-service
-- ⏳ Launch respons (nästa vecka)
-
-**Nästa:**
-- Fler Direct Call partnerships
-- Stripe payments live
-- Usage analytics för providers
-
----
-
-## 📝 Ändringslogg
-
-| Datum | Ändring |
-|-------|---------|
-| 2026-02-26 | 🎉 **Launch pitch genomförd!** Demo fungerade perfekt |
-| 2026-02-26 | NordSym Echo API skapad + Direct Call konfigurerat live |
-| 2026-02-26 | Whisper-transkribering via Replicate bevisade proxy-konceptet |
-| 2026-02-26 | Provider dashboard delete-funktion tillagd |
-| 2026-02-26 | Direct Call modal på landningssidan (klicka på "11" för att se alla) |
-| 2026-02-22 | 15,000 APIs milestone |
-| 2026-02-16 | npm v1.0.0 publicerad |
-
----
-
-*Senast verifierad: 26 Feb 2026, kl 18:50 CET*