@i18n-agent/mcp-client 1.8.0 → 1.8.2

package/README.md

@@ -76,12 +76,15 @@ Analyze "Hello world! This is a test." for translation to Spanish
 
 ## 🛠 Supported AI IDEs
 
-| IDE | Status | Config Location |
-|-----|--------|----------------|
-| **Claude Desktop** | ✅ Auto-configured | `~/Library/Application Support/Claude/claude_desktop_config.json` |
-| **Cursor** | ✅ Auto-configured | `~/.cursor/mcp_settings.json` |
-| **VS Code** | ✅ Auto-configured | `~/.vscode/mcp_settings.json` |
-| **Other MCP IDEs** | 🔧 Manual setup | Varies |
+| IDE | Status | macOS | Windows | Linux |
+|-----|--------|-------|---------|-------|
+| **Claude Desktop** | ✅ Auto-configured | `~/Library/Application Support/Claude/` | `%APPDATA%\Claude\` | `~/.config/Claude/` |
+| **Claude Code CLI** | ✅ Auto-configured | `~/.claude.json` | `~/.claude.json` | `~/.claude.json` |
+| **Cursor** | ✅ Auto-configured | `~/.cursor/mcp_settings.json` | `~/.cursor/mcp_settings.json` | `~/.cursor/mcp_settings.json` |
+| **VS Code** | ✅ Auto-configured | `~/.vscode/mcp_settings.json` | `~/.vscode/mcp_settings.json` | `~/.vscode/mcp_settings.json` |
+| **Codex (OpenAI)** | ✅ Auto-configured | `~/.codex/mcp_settings.json` | `~/.codex/mcp_settings.json` | `~/.codex/mcp_settings.json` |
+
+**Note:** The installer automatically detects your platform and uses the correct config paths.
 
 ## 🌐 Language Support (48 Languages)
 - **bg**: Bulgarian

package/install.js

@@ -12,12 +12,42 @@ import { fileURLToPath } from 'url';
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 
+// Helper to get platform-specific paths
+function getClaudeDesktopPath() {
+  const platform = process.platform;
+  if (platform === 'darwin') {
+    // macOS
+    return {
+      configPath: path.join(os.homedir(), 'Library/Application Support/Claude/claude_desktop_config.json'),
+      displayPath: '~/Library/Application Support/Claude/claude_desktop_config.json'
+    };
+  } else if (platform === 'win32') {
+    // Windows
+    return {
+      configPath: path.join(os.homedir(), 'AppData/Roaming/Claude/claude_desktop_config.json'),
+      displayPath: '%APPDATA%\\Claude\\claude_desktop_config.json'
+    };
+  } else {
+    // Linux
+    return {
+      configPath: path.join(os.homedir(), '.config/Claude/claude_desktop_config.json'),
+      displayPath: '~/.config/Claude/claude_desktop_config.json'
+    };
+  }
+}
+
 // Supported IDE configurations
+const claudePaths = getClaudeDesktopPath();
 const IDE_CONFIGS = {
   claude: {
     name: 'Claude Desktop',
-    configPath: path.join(os.homedir(), 'Library/Application Support/Claude/claude_desktop_config.json'),
-    displayPath: '~/Library/Application Support/Claude/claude_desktop_config.json'
+    configPath: claudePaths.configPath,
+    displayPath: claudePaths.displayPath
+  },
+  'claude-code': {
+    name: 'Claude Code CLI',
+    configPath: path.join(os.homedir(), '.claude.json'),
+    displayPath: '~/.claude.json'
   },
   cursor: {
     name: 'Cursor',
@@ -28,6 +58,11 @@ const IDE_CONFIGS = {
     name: 'VS Code (with MCP extension)',
     configPath: path.join(os.homedir(), '.vscode/mcp_settings.json'),
     displayPath: '~/.vscode/mcp_settings.json'
+  },
+  codex: {
+    name: 'Codex (OpenAI)',
+    configPath: path.join(os.homedir(), '.codex/mcp_settings.json'),
+    displayPath: '~/.codex/mcp_settings.json'
   }
 };
 
@@ -42,6 +77,9 @@ Features:
 📁 File translation (JSON, YAML, CSV, MD, etc.)
 💰 Credit balance checking
 🌐 48 languages supported with regional variants
+
+🔑 IMPORTANT: Get your API key at https://app.i18nagent.ai
+   (Required for the MCP client to work)
 `);
 
 const getMcpClientPaths = () => {
@@ -206,8 +244,10 @@ async function main() {
 
 Supported IDEs:
 - Claude Desktop (macOS)
+- Claude Code CLI
 - Cursor
 - VS Code (with MCP extension)
+- Codex (OpenAI)
 
 Manual setup:
 1. Create the configuration file for your IDE
@@ -225,45 +265,70 @@ For manual setup instructions, visit: https://docs.i18nagent.ai/setup
     });
     
     console.log('\n📝 Installing for all available IDEs...\n');
-    
+
     let installCount = 0;
-    
+    const installedIDEs = [];
+
     for (const ide of availableIDEs) {
       try {
         console.log(`⚙️  Configuring ${ide.name}...`);
-        
-        if (ide.key === 'claude') {
+
+        if (ide.key === 'claude' || ide.key === 'claude-code') {
           updateClaudeConfig(ide.configPath);
         } else {
           updateGenericMCPConfig(ide.configPath);
         }
-        
+
         console.log(`✅ ${ide.name} configured successfully!`);
         console.log(`   Config: ${ide.displayPath}\n`);
         installCount++;
-        
+        installedIDEs.push(ide);
+
       } catch (error) {
         console.error(`❌ Failed to configure ${ide.name}: ${error.message}\n`);
       }
     }
-    
+
     if (installCount > 0) {
+      // Show config file paths for ONLY installed IDEs
+      const configPaths = installedIDEs.map(ide => `   - ${ide.name}: ${ide.displayPath}`).join('\n');
+
+      // Platform-specific environment variable instructions
+      const isWindows = process.platform === 'win32';
+      const envVarInstructions = isWindows
+        ? `   Windows PowerShell:
+   $env:API_KEY="your-api-key-here"
+
+   Or set permanently via System Environment Variables:
+   1. Search "Environment Variables" in Windows
+   2. Click "New" under User variables
+   3. Variable name: API_KEY
+   4. Variable value: your-api-key-here`
+        : `   macOS/Linux:
+   export API_KEY=your-api-key-here
+
+   Add to shell profile for persistence (~/.bashrc, ~/.zshrc):
+   echo 'export API_KEY=your-api-key-here' >> ~/.zshrc`;
+
       console.log(`🎉 Installation complete! Configured ${installCount} IDE(s).
 
-🔑 Important: Set your API key
+🔑 NEXT STEP: Add your API key
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-You need to set your API key to use the translation service:
-
 1. Get your API key from: https://app.i18nagent.ai
-2. Set it as an environment variable:
 
-   export API_KEY=your-api-key-here
+2. Add it to your config file(s):
+${configPaths}
+
+   Open the file and add your API key to the "env" section:
+   "env": {
+     "MCP_SERVER_URL": "https://mcp.i18nagent.ai",
+     "API_KEY": "your-api-key-here"  ← Add your key here
+   }
 
-   Or add it to your shell profile (~/.bashrc, ~/.zshrc):
-   echo 'export API_KEY=your-api-key-here' >> ~/.zshrc
+   OR set as environment variable:
+${envVarInstructions}
 
-🔄 Restart your IDE
-After setting the API key, restart your AI IDE to load the new configuration.
+3. Restart your IDE to load the configuration
 
 🧪 Test the installation
 Try these commands in your AI IDE:

package/mcp-client.js

@@ -5,7 +5,7 @@
  * Integrates with Claude Code CLI to provide translation capabilities
  */
 
-const MCP_CLIENT_VERSION = '1.8.0';
+const MCP_CLIENT_VERSION = '1.8.2';
 
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
@@ -334,26 +334,40 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
     }
   } catch (error) {
     console.error(`Error executing tool ${name}:`, error);
-    
+
     // Check if error is about API key or credit issues
     const errorMsg = error.message || '';
-    const isAuthError = errorMsg.toLowerCase().includes('api key') || 
+    const isAuthError = errorMsg.toLowerCase().includes('api key') ||
                        errorMsg.toLowerCase().includes('api_key') ||
                        errorMsg.toLowerCase().includes('unauthorized') ||
                        errorMsg.includes('(401)');
-    const isCreditError = errorMsg.toLowerCase().includes('credit') || 
+    const isCreditError = errorMsg.toLowerCase().includes('credit') ||
                          errorMsg.toLowerCase().includes('quota') ||
                          errorMsg.toLowerCase().includes('limit exceeded') ||
                          errorMsg.includes('(402)');
-    
+
+    // Check if error is already descriptive (validation errors, specific errors with clear messages)
+    const hasDescriptiveError = errorMsg.includes('Invalid language code') ||
+                               errorMsg.includes('is a multilingual region') ||
+                               errorMsg.includes('not found') ||
+                               errorMsg.includes('timed out') ||
+                               errorMsg.includes('Timeout') ||
+                               errorMsg.includes('Required') ||
+                               errorMsg.includes('must be') ||
+                               errorMsg.includes('is required') ||
+                               errorMsg.length > 200; // Long errors are likely already detailed
+
     let finalErrorMsg = error.message;
-    
-    // Add retry guidance for non-auth/credit errors (only for tools that send content)
+
+    // Only add retry guidance if:
+    // 1. It's not an auth/credit error
+    // 2. It's a content-based tool
+    // 3. The error is NOT already descriptive
     const contentBasedTools = ['translate_text', 'translate_file'];
-    if (!isAuthError && !isCreditError && contentBasedTools.includes(name)) {
+    if (!isAuthError && !isCreditError && !hasDescriptiveError && contentBasedTools.includes(name)) {
       finalErrorMsg = `${error.message}. Please retry with smaller chunks or split the content into multiple requests.`;
     }
-    
+
     throw new McpError(
       ErrorCode.InternalError,
       `Tool execution failed: ${finalErrorMsg}`

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@i18n-agent/mcp-client",
-  "version": "1.8.0",
-  "description": "MCP client for i18n-agent translation service with async job support and enhanced progress tracking - supports Claude, Cursor, VS Code, and other AI IDEs",
+  "version": "1.8.2",
+  "description": "🌍 i18n-agent MCP Client - 48 languages, AI-powered translation for Claude, Claude Code, Cursor, VS Code, Codex. Get API key at https://app.i18nagent.ai",
   "main": "mcp-client.js",
   "bin": {
     "i18n-agent-install": "install.js"