@i18n-agent/mcp-client 1.9.8 → 1.12.0

package/CONTRIBUTING.md

@@ -34,7 +34,7 @@ npm test
 node install.js
 
 # Test MCP client syntax
-node -c mcp-client.js
+node -c i18n-agent.js
 ```
 
 ## 📝 Types of Contributions
@@ -72,7 +72,7 @@ npm test
 node install.js
 
 # Check for syntax errors
-node -c mcp-client.js
+node -c i18n-agent.js
 node -c install.js
 ```
 

package/README.md

@@ -1,6 +1,6 @@
 # 🌍 i18n-agent MCP Client
 
-Professional translation service client for Claude, Cursor, VS Code, and other AI IDEs using the Model Context Protocol (MCP).
+Professional translation service client for Claude, Cursor, VS Code, Antigravity, and other AI IDEs using the Model Context Protocol (MCP).
 
 [![npm version](https://badge.fury.io/js/%40i18n-agent%2Fmcp-client.svg)](https://www.npmjs.com/package/@i18n-agent/mcp-client)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
@@ -20,7 +20,7 @@ Professional translation service client for Claude, Cursor, VS Code, and other A
 
 ```bash
 npm install -g @i18n-agent/mcp-client
-mcp-client
+i18n-agent
 ```
 
 **Note:** Global installation is required due to npm bin naming limitations. The installer will detect all available AI IDEs and configure them automatically.
@@ -77,6 +77,7 @@ Analyze "Hello world! This is a test." for translation to Spanish
 | **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` |
+| **Antigravity (Google)** | ✅ Auto-configured | `~/.gemini/antigravity/mcp_config.json` | `%USERPROFILE%\.gemini\antigravity\mcp_config.json` | `~/.config/antigravity/mcp_config.json` |
 
 **Note:** The installer automatically detects your platform and uses the correct config paths.
 
@@ -156,7 +157,7 @@ Edit `~/Library/Application Support/Claude/claude_desktop_config.json`:
   "mcpServers": {
     "i18n-agent": {
       "command": "node",
-      "args": ["/path/to/mcp-client.js"],
+      "args": ["/path/to/i18n-agent.js"],
       "env": {
         "MCP_SERVER_URL": "https://mcp.i18nagent.ai",
         "API_KEY": "your-api-key-here"
@@ -174,7 +175,7 @@ Create `.cursor/mcp_settings.json` or `.vscode/mcp_settings.json`:
   "mcpServers": {
     "i18n-agent": {
       "command": "node", 
-      "args": ["/path/to/mcp-client.js"],
+      "args": ["/path/to/i18n-agent.js"],
       "env": {
         "MCP_SERVER_URL": "https://mcp.i18nagent.ai",
         "API_KEY": "your-api-key-here"
@@ -252,7 +253,7 @@ This usually happens with Node Version Managers (nvm, fnm, n). The installer now
    #!/bin/bash
    export PATH="$(dirname $(which node)):$PATH"
    cd ~/.claude
-   exec node node_modules/@i18n-agent/mcp-client/mcp-client.js
+   exec node node_modules/@i18n-agent/mcp-client/i18n-agent.js
    ```
    
    Make it executable:

package/{mcp-client.js → i18n-agent.js}

@@ -5,7 +5,7 @@
  * Integrates with Claude Code CLI to provide translation capabilities
  */
 
-const MCP_CLIENT_VERSION = '1.9.8';
+const MCP_CLIENT_VERSION = '1.12.0';
 
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
@@ -43,6 +43,40 @@ if (!process.env.API_KEY) {
 const MCP_SERVER_URL = process.env.MCP_SERVER_URL;
 const API_KEY = process.env.API_KEY;
 
+// Heavy load detection - matches error message from service-mcp error-message-sanitizer
+// Exact message: 'Our system is under heavy load, please resume your job later.'
+const HEAVY_LOAD_PATTERNS = [
+  /Our system is under heavy load/i,
+  /system is under heavy load.*resume.*later/i,
+];
+
+const HEAVY_LOAD_MESSAGE = `⏳ System under heavy load
+
+The translation service is experiencing high demand. Your job has been saved and can be resumed later.
+
+⚠️ IMPORTANT FOR AI AGENTS:
+• Do NOT retry or resume immediately - this will likely fail again
+• Do NOT poll check_translation_status repeatedly
+• Wait at least 5-10 minutes before attempting to resume
+• The job is saved - no data is lost
+
+🔄 To resume later:
+1. Wait for system load to decrease (5-10 minutes minimum)
+2. Use resume_translation with the same jobId
+3. If it fails again, wait longer before retrying
+
+💡 Tip: Inform the user about the delay and let them decide when to retry.`;
+
+/**
+ * Check if an error message indicates heavy system load
+ * @param {string} errorMessage - The error message to check
+ * @returns {boolean} - True if the error indicates heavy load
+ */
+function isHeavyLoadError(errorMessage) {
+  if (!errorMessage) return false;
+  return HEAVY_LOAD_PATTERNS.some(pattern => pattern.test(errorMessage));
+}
+
 // Available tools
 server.setRequestHandler(ListToolsRequestSchema, async () => {
   return {
@@ -689,26 +723,35 @@ async function handleTranslateText(args) {
       throw new Error(errorMsg);
     }
     
+    // Check for heavy load error (from service-mcp error-message-sanitizer)
+    const errorDetails = error.response?.data?.result?.content?.[0]?.text ||
+                        error.response?.data?.error?.message ||
+                        error.response?.data?.message ||
+                        error.message;
+    if (isHeavyLoadError(errorDetails)) {
+      throw new Error(`${HEAVY_LOAD_MESSAGE}\n[MCP v${MCP_CLIENT_VERSION}/STDIO/translate_text]`);
+    }
+
     // Check if it's actually a service unavailable error (only for real infrastructure issues)
     if (error.response?.status === 503) {
       throw new Error(`i18n-agent encountered unexpected problem, and we are working on it, try again later.`);
     }
-    
-    if (error.code === 'ECONNREFUSED' || 
-        error.code === 'ETIMEDOUT' || 
+
+    if (error.code === 'ECONNREFUSED' ||
+        error.code === 'ETIMEDOUT' ||
         error.code === 'ENOTFOUND' ||
         error.response?.status === 502 ||
         error.response?.status === 504) {
-      const serviceErrorDetails = error.response?.data?.result?.content?.[0]?.text || 
-                                  error.response?.data?.error?.message || 
+      const serviceErrorDetails = error.response?.data?.result?.content?.[0]?.text ||
+                                  error.response?.data?.error?.message ||
                                   error.message;
       const debugInfo = `Code: ${error.code || 'N/A'}\nStatus: ${error.response?.status || 'N/A'}\nStatusText: ${error.response?.statusText || 'N/A'}\nDetails: ${serviceErrorDetails}\nURL: ${error.config?.url || 'N/A'}\nTimestamp: ${new Date().toISOString()}`;
       throw new Error(`Translation service error\n${debugInfo}\n[MCP v${MCP_CLIENT_VERSION}/STDIO/translate_text]`);
     }
-    
+
     // For other errors, include all debug info in the error message
-    const generalErrorDetails = error.response?.data?.result?.content?.[0]?.text || 
-                               error.response?.data?.error?.message || 
+    const generalErrorDetails = error.response?.data?.result?.content?.[0]?.text ||
+                               error.response?.data?.error?.message ||
                                error.message;
     const debugInfo = `Status: ${error.response?.status || 'N/A'}\nStatusText: ${error.response?.statusText || 'N/A'}\nDetails: ${generalErrorDetails}\nTimestamp: ${new Date().toISOString()}`;
     throw new Error(`Error\n${debugInfo}\n[MCP v${MCP_CLIENT_VERSION}/STDIO/translate_text]`);
@@ -1046,26 +1089,31 @@ async function handleTranslateFile(args) {
       throw new Error(errorMsg);
     }
     
+    // Check for heavy load error (from service-mcp error-message-sanitizer)
+    if (isHeavyLoadError(timeoutErrorDetails)) {
+      throw new Error(`${HEAVY_LOAD_MESSAGE}\n[MCP v${MCP_CLIENT_VERSION}/STDIO/translate_file]`);
+    }
+
     // Check if it's actually a service unavailable error (only for real infrastructure issues)
     if (error.response?.status === 503 && content.length <= 50000) {
       throw new Error(`i18n-agent encountered unexpected problem, and we are working on it, try again later.`);
     }
-    
-    if (error.code === 'ECONNREFUSED' || 
-        error.code === 'ETIMEDOUT' || 
+
+    if (error.code === 'ECONNREFUSED' ||
+        error.code === 'ETIMEDOUT' ||
         error.code === 'ENOTFOUND' ||
         error.response?.status === 502 ||
         error.response?.status === 504) {
-      const serviceErrorDetails = error.response?.data?.result?.content?.[0]?.text || 
-                                  error.response?.data?.error?.message || 
+      const serviceErrorDetails = error.response?.data?.result?.content?.[0]?.text ||
+                                  error.response?.data?.error?.message ||
                                   error.message;
       const debugInfo = `Code: ${error.code || 'N/A'}\nStatus: ${error.response?.status || 'N/A'}\nStatusText: ${error.response?.statusText || 'N/A'}\nDetails: ${serviceErrorDetails}\nURL: ${error.config?.url || 'N/A'}\nTimestamp: ${new Date().toISOString()}`;
       throw new Error(`Translation service error\n${debugInfo}\n[MCP v${MCP_CLIENT_VERSION}/STDIO/translate_file]`);
     }
-    
+
     // For other errors, include all debug info in the error message
-    const finalErrorDetails = error.response?.data?.result?.content?.[0]?.text || 
-                              error.response?.data?.error?.message || 
+    const finalErrorDetails = error.response?.data?.result?.content?.[0]?.text ||
+                              error.response?.data?.error?.message ||
                               error.message;
     const debugInfo = `Status: ${error.response?.status || 'N/A'}\nStatusText: ${error.response?.statusText || 'N/A'}\nDetails: ${finalErrorDetails}\nTimestamp: ${new Date().toISOString()}`;
     throw new Error(`Error\n${debugInfo}\n[MCP v${MCP_CLIENT_VERSION}/STDIO/translate_file]`);
@@ -1122,48 +1170,64 @@ async function pollTranslationJob(jobId, estimatedTime) {
       
       if (response.data.error) {
         const errorMsg = response.data.error.message || response.data.error;
-        const isAuthError = errorMsg.toString().toLowerCase().includes('api key') || 
+
+        // Check for heavy load error - stop polling immediately
+        if (isHeavyLoadError(errorMsg.toString())) {
+          throw new Error(`${HEAVY_LOAD_MESSAGE}\n\nJob ID: ${jobId}\n[MCP v${MCP_CLIENT_VERSION}/pollTranslationJob]`);
+        }
+
+        const isAuthError = errorMsg.toString().toLowerCase().includes('api key') ||
                            errorMsg.toString().toLowerCase().includes('api_key') ||
                            errorMsg.toString().toLowerCase().includes('unauthorized');
-        const isCreditError = errorMsg.toString().toLowerCase().includes('credit') || 
+        const isCreditError = errorMsg.toString().toLowerCase().includes('credit') ||
                              errorMsg.toString().toLowerCase().includes('quota') ||
                              errorMsg.toString().toLowerCase().includes('limit exceeded');
-        
+
         let finalErrorMsg = `Status check error: ${errorMsg}`;
         if (!isAuthError && !isCreditError) {
           finalErrorMsg += `. Please retry with a smaller chunk or split the content into multiple requests.`;
         }
         throw new Error(finalErrorMsg);
       }
-      
+
       const result = response.data.result;
       if (result && result.content && result.content[0]) {
         const status = JSON.parse(result.content[0].text);
-        
+
         if (status.status === 'completed') {
           return status.result;
         } else if (status.status === 'failed') {
           const errorMsg = status.error;
-          const isAuthError = errorMsg.toString().toLowerCase().includes('api key') || 
+
+          // Check for heavy load error - stop polling immediately
+          if (isHeavyLoadError(errorMsg.toString())) {
+            throw new Error(`${HEAVY_LOAD_MESSAGE}\n\nJob ID: ${jobId}\n[MCP v${MCP_CLIENT_VERSION}/pollTranslationJob]`);
+          }
+
+          const isAuthError = errorMsg.toString().toLowerCase().includes('api key') ||
                              errorMsg.toString().toLowerCase().includes('api_key') ||
                              errorMsg.toString().toLowerCase().includes('unauthorized');
-          const isCreditError = errorMsg.toString().toLowerCase().includes('credit') || 
+          const isCreditError = errorMsg.toString().toLowerCase().includes('credit') ||
                                errorMsg.toString().toLowerCase().includes('quota') ||
                                errorMsg.toString().toLowerCase().includes('limit exceeded');
-          
+
           let finalErrorMsg = `Translation failed: ${errorMsg}`;
           if (!isAuthError && !isCreditError) {
             finalErrorMsg += `. Please retry with a smaller chunk or split the content into multiple requests.`;
           }
           throw new Error(finalErrorMsg);
         }
-        
+
         // Still processing - continue polling
         console.error(`Translation progress: ${status.progress}% (${status.message})`);
       }
     } catch (error) {
+      // Check for heavy load error - stop polling immediately (don't continue)
+      if (isHeavyLoadError(error.message)) {
+        throw error; // Re-throw heavy load error to stop polling
+      }
       console.error(`Error polling job status: ${error.message}`);
-      // Continue polling even if status check fails
+      // Continue polling for other transient errors
     }
   }
   
@@ -1727,6 +1791,17 @@ async function handleCheckTranslationStatus(args) {
   } catch (error) {
     console.error('Check translation status error:', error);
 
+    // Extract error message from various response formats
+    const errorDetails = error.response?.data?.result?.content?.[0]?.text ||
+                        error.response?.data?.error?.message ||
+                        error.response?.data?.message ||
+                        error.message;
+
+    // Check for heavy load error (from service-mcp error-message-sanitizer)
+    if (isHeavyLoadError(errorDetails)) {
+      throw new Error(`${HEAVY_LOAD_MESSAGE}\n\nJob ID: ${jobId}\n[MCP v${MCP_CLIENT_VERSION}/check_translation_status]`);
+    }
+
     // Handle 503 service unavailable
     if (error.response?.status === 503) {
       throw new Error(`i18n-agent encountered unexpected problem, and we are working on it, try again later.`);
@@ -1779,6 +1854,17 @@ async function handleResumeTranslation(args) {
   } catch (error) {
     console.error('Resume translation error:', error);
 
+    // Extract error message from various response formats
+    const errorDetails = error.response?.data?.result?.content?.[0]?.text ||
+                        error.response?.data?.error?.message ||
+                        error.response?.data?.message ||
+                        error.message;
+
+    // Check for heavy load error (from service-mcp error-message-sanitizer)
+    if (isHeavyLoadError(errorDetails)) {
+      throw new Error(`${HEAVY_LOAD_MESSAGE}\n\nJob ID: ${jobId}\n[MCP v${MCP_CLIENT_VERSION}/resume_translation]`);
+    }
+
     // Handle 503 service unavailable
     if (error.response?.status === 503) {
       throw new Error(`i18n-agent encountered unexpected problem, and we are working on it, try again later.`);
@@ -1930,6 +2016,17 @@ async function handleDownloadTranslations(args) {
   } catch (error) {
     console.error('Download translations error:', error);
 
+    // Extract error message from various response formats
+    const errorDetails = error.response?.data?.result?.content?.[0]?.text ||
+                        error.response?.data?.error?.message ||
+                        error.response?.data?.message ||
+                        error.message;
+
+    // Check for heavy load error (from service-mcp error-message-sanitizer)
+    if (isHeavyLoadError(errorDetails)) {
+      throw new Error(`${HEAVY_LOAD_MESSAGE}\n\nJob ID: ${jobId}\n[MCP v${MCP_CLIENT_VERSION}/download_translations]`);
+    }
+
     // Handle 503 service unavailable
     if (error.response?.status === 503) {
       throw new Error(`i18n-agent encountered unexpected problem, and we are working on it, try again later.`);

package/install.js

@@ -37,8 +37,32 @@ function getClaudeDesktopPath() {
   }
 }
 
+function getAntigravityPath() {
+  const platform = process.platform;
+  if (platform === 'darwin') {
+    // macOS
+    return {
+      configPath: path.join(os.homedir(), '.gemini/antigravity/mcp_config.json'),
+      displayPath: '~/.gemini/antigravity/mcp_config.json'
+    };
+  } else if (platform === 'win32') {
+    // Windows
+    return {
+      configPath: path.join(os.homedir(), '.gemini/antigravity/mcp_config.json'),
+      displayPath: '%USERPROFILE%\\.gemini\\antigravity\\mcp_config.json'
+    };
+  } else {
+    // Linux
+    return {
+      configPath: path.join(os.homedir(), '.config/antigravity/mcp_config.json'),
+      displayPath: '~/.config/antigravity/mcp_config.json'
+    };
+  }
+}
+
 // Supported IDE configurations
 const claudePaths = getClaudeDesktopPath();
+const antigravityPaths = getAntigravityPath();
 const IDE_CONFIGS = {
   claude: {
     name: 'Claude Desktop',
@@ -64,6 +88,11 @@ const IDE_CONFIGS = {
     name: 'Codex (OpenAI)',
     configPath: path.join(os.homedir(), '.codex/mcp_settings.json'),
     displayPath: '~/.codex/mcp_settings.json'
+  },
+  antigravity: {
+    name: 'Antigravity (Google)',
+    configPath: antigravityPaths.configPath,
+    displayPath: antigravityPaths.displayPath
   }
 };
 
@@ -83,9 +112,9 @@ Features:
 const getMcpClientPaths = () => {
   // Instead of using ephemeral npx cache, install to stable location
   const stableDir = path.join(os.homedir(), '.claude', 'mcp-servers', 'i18n-agent');
-  const mcpClientPath = path.join(stableDir, 'mcp-client.js');
+  const mcpClientPath = path.join(stableDir, 'i18n-agent.js');
   const packageDir = stableDir;
-  return { mcpClientPath, packageDir, sourceFile: path.resolve(__dirname, 'mcp-client.js') };
+  return { mcpClientPath, packageDir, sourceFile: path.resolve(__dirname, 'i18n-agent.js') };
 };
 
 function copyMcpClientToStableLocation() {
@@ -94,7 +123,7 @@ function copyMcpClientToStableLocation() {
   // Create stable directory
   fs.mkdirSync(paths.packageDir, { recursive: true });
 
-  // Copy mcp-client.js to stable location
+  // Copy i18n-agent.js to stable location
   fs.copyFileSync(paths.sourceFile, paths.mcpClientPath);
 
   // Copy package.json to stable location
@@ -598,6 +627,7 @@ Supported IDEs:
 - Cursor
 - VS Code (with MCP extension)
 - Codex (OpenAI)
+- Antigravity (Google)
 
 Manual setup:
 1. Create the configuration file for your IDE
@@ -808,7 +838,7 @@ Step 2: Add API key to your IDE`);
           console.log(`
    For Claude Code CLI (recommended):
    claude mcp remove --scope user i18n-agent
-   claude mcp add --transport stdio --scope user i18n-agent -e MCP_SERVER_URL=https://mcp.i18nagent.ai -e API_KEY=your_key_here -- node ~/.claude/mcp-servers/i18n-agent/mcp-client.js
+   claude mcp add --transport stdio --scope user i18n-agent -e MCP_SERVER_URL=https://mcp.i18nagent.ai -e API_KEY=your_key_here -- node ~/.claude/mcp-servers/i18n-agent/i18n-agent.js
 `);
         }
 
@@ -816,7 +846,7 @@ Step 2: Add API key to your IDE`);
           console.log(`
    For Codex CLI (recommended):
    codex mcp remove i18n-agent
-   codex mcp add --env MCP_SERVER_URL=https://mcp.i18nagent.ai --env API_KEY=your_key_here i18n-agent node ~/.claude/mcp-servers/i18n-agent/mcp-client.js
+   codex mcp add --env MCP_SERVER_URL=https://mcp.i18nagent.ai --env API_KEY=your_key_here i18n-agent node ~/.claude/mcp-servers/i18n-agent/i18n-agent.js
 `);
         }
 
@@ -873,7 +903,7 @@ Try these commands in your AI IDE:
 const isMainModule = process.argv[1] && (
   import.meta.url === `file://${process.argv[1]}` ||
   import.meta.url.endsWith(process.argv[1]) ||
-  process.argv[1].includes('mcp-client')
+  process.argv[1].includes('i18n-agent')
 );
 
 if (isMainModule) {

package/package.json

@@ -1,16 +1,16 @@
 {
   "name": "@i18n-agent/mcp-client",
-  "version": "1.9.8",
+  "version": "1.12.0",
   "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",
+  "main": "i18n-agent.js",
   "bin": {
-    "mcp-client": "install.js"
+    "i18n-agent": "install.js"
   },
   "type": "module",
   "scripts": {
     "install": "node install.js",
     "test": "node test.js",
-    "postinstall": "echo '\n🌍 i18n-agent MCP Client installed successfully!\n💡 Run: mcp-client (if installed globally) or node install.js\n'"
+    "postinstall": "echo '\n🌍 i18n-agent MCP Client installed successfully!\n💡 Run: i18n-agent (if installed globally) or node install.js\n'"
   },
   "repository": {
     "type": "git",
@@ -42,7 +42,7 @@
     "node": ">=16.0.0"
   },
   "files": [
-    "mcp-client.js",
+    "i18n-agent.js",
     "namespace-detector.js",
     "install.js",
     "README.md",