@i18n-agent/mcp-client 1.1.1 → 1.1.3

package/mcp-client.js

@@ -5,6 +5,8 @@
  * Integrates with Claude Code CLI to provide translation capabilities
  */
 
+const MCP_CLIENT_VERSION = '1.1.2';
+
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import {
@@ -20,7 +22,7 @@ import path from 'path';
 const server = new Server(
   {
     name: 'i18n-agent',
-    version: '1.0.0',
+    version: MCP_CLIENT_VERSION,
   },
   {
     capabilities: {
@@ -305,17 +307,47 @@ async function handleTranslateText(args) {
       };
     }
     
-    // Check if it's actually a service unavailable error (503, timeout, connection issues)
+    // Handle 401 unauthorized - invalid API key
+    if (error.response?.status === 401) {
+      const errorDetails = error.response.data?.message || error.response.data?.result?.content?.[0]?.text || error.message;
+      throw new Error(`❌ Invalid API key (401)\nDetails: ${errorDetails}\nPlease check your API key at https://app.i18nagent.ai\n[MCP v${MCP_CLIENT_VERSION}/STDIO/translate_text]`);
+    }
+    
+    // Handle 402 payment required with user-friendly message
+    if (error.response?.status === 402) {
+      const errorDetails = error.response.data?.message || error.response.data?.result?.content?.[0]?.text || error.message;
+      throw new Error(`⚠️ Insufficient credits (402)\nDetails: ${errorDetails}\nPlease top up at https://app.i18nagent.ai\n[MCP v${MCP_CLIENT_VERSION}/STDIO/translate_text]`);
+    }
+    
+    // Check if it's a large content issue
+    const totalChars = texts.reduce((sum, text) => sum + text.length, 0);
+    if (error.response?.status === 413 || 
+        (error.response?.status === 503 && totalChars > 50000)) {
+      const errorDetails = error.response?.data?.message || error.response?.data?.result?.content?.[0]?.text || error.message;
+      const errorMsg = `Content too large (${totalChars} characters, ${texts.length} texts)\nStatus: ${error.response?.status}\nDetails: ${errorDetails}\n\nPlease break into smaller batches:\n• Split into batches of 50-100 texts\n• Keep total size under 50KB per request\n• Process sequentially to avoid overload\n[MCP v${MCP_CLIENT_VERSION}/STDIO/translate_text]`;
+      throw new Error(errorMsg);
+    }
+    
+    // Check if it's actually a service unavailable error (only for real infrastructure issues)
     if (error.code === 'ECONNREFUSED' || 
         error.code === 'ETIMEDOUT' || 
-        error.response?.status === 503 ||
+        error.code === 'ENOTFOUND' ||
+        (error.response?.status === 503 && totalChars <= 50000) ||
         error.response?.status === 502 ||
         error.response?.status === 504) {
-      throw new Error(`Translation service unavailable: ${error.message}`);
+      const errorDetails = 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: ${errorDetails}\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 (401, 402, 404, etc), throw them as-is without "unavailable" keyword
-    throw error;
+    // For other errors, include all debug info in the error message
+    const errorDetails = 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: ${errorDetails}\nTimestamp: ${new Date().toISOString()}`;
+    throw new Error(`Error\n${debugInfo}\n[MCP v${MCP_CLIENT_VERSION}/STDIO/translate_text]`);
   }
 }
 
@@ -485,6 +517,8 @@ async function handleTranslateFile(args) {
     return result;
     
   } catch (error) {
+    // Debug info will be included in error messages for visibility
+    
     if (error.code === 'ECONNABORTED') {
       return {
         content: [
@@ -507,17 +541,50 @@ async function handleTranslateFile(args) {
       };
     }
     
-    // Check if it's actually a service unavailable error
+    // Handle 401 unauthorized - invalid API key
+    if (error.response?.status === 401) {
+      const errorDetails = error.response.data?.message || error.response.data?.result?.content?.[0]?.text || error.message;
+      throw new Error(`❌ Invalid API key (401)\nDetails: ${errorDetails}\nPlease check your API key at https://app.i18nagent.ai\n[MCP v${MCP_CLIENT_VERSION}/STDIO/translate_file]`);
+    }
+    
+    // Handle 402 payment required with user-friendly message
+    if (error.response?.status === 402) {
+      const errorDetails = error.response.data?.message || error.response.data?.result?.content?.[0]?.text || error.message;
+      throw new Error(`⚠️ Insufficient credits (402)\nDetails: ${errorDetails}\nPlease top up at https://app.i18nagent.ai\n[MCP v${MCP_CLIENT_VERSION}/STDIO/translate_file]`);
+    }
+    
+    // Check if it's a timeout issue (45-second server timeout) or large file issue
+    const errorDetails = error.response?.data?.result?.content?.[0]?.text || 
+                        error.response?.data?.error?.message || 
+                        error.message;
+    
+    if (error.response?.status === 413 || 
+        (error.response?.status === 503 && content.length > 50000) ||
+        (error.response?.status === 503 && errorDetails.includes('timeout after 45 seconds'))) {
+      const errorMsg = `File too large or complex (${content.length} characters)\n\nThe server has a 45-second timeout. Your file requires more processing time.\n\nPlease break into smaller chunks:\n• Split files over 50KB into multiple parts\n• Translate sections separately (e.g., split by top-level keys for JSON)\n• Use translate_text for batches of 50-100 strings\n• Each chunk should process in under 45 seconds\n\nAlternatively, wait for async job support (coming soon).\n[MCP v${MCP_CLIENT_VERSION}/STDIO/translate_file]`;
+      throw new Error(errorMsg);
+    }
+    
+    // Check if it's actually a service unavailable error (only for real infrastructure issues)
     if (error.code === 'ECONNREFUSED' || 
         error.code === 'ETIMEDOUT' || 
-        error.response?.status === 503 ||
+        error.code === 'ENOTFOUND' ||
+        (error.response?.status === 503 && content.length <= 50000) ||
         error.response?.status === 502 ||
         error.response?.status === 504) {
-      throw new Error(`Translation service unavailable: ${error.message}`);
+      const errorDetails = 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: ${errorDetails}\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, throw them as-is without "unavailable" keyword
-    throw error;
+    // For other errors, include all debug info in the error message
+    const errorDetails = 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: ${errorDetails}\nTimestamp: ${new Date().toISOString()}`;
+    throw new Error(`Error\n${debugInfo}\n[MCP v${MCP_CLIENT_VERSION}/STDIO/translate_file]`);
   }
 }
 
@@ -597,7 +664,7 @@ async function pollTranslationJob(jobId, estimatedTime) {
 async function handleGetCredits(args) {
   try {
     // Get team info first using the API key
-    const teamResponse = await axios.get(`https://platform.i18nagent.ai/api/teams/by-api-key/${API_KEY}`, {
+    const teamResponse = await axios.get(`https://app.i18nagent.ai/api/teams/by-api-key/${API_KEY}`, {
       headers: {
         'Content-Type': 'application/json'
       },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@i18n-agent/mcp-client",
-  "version": "1.1.1",
+  "version": "1.1.3",
   "description": "MCP client for i18n-agent translation service - supports Claude, Cursor, VS Code, and other AI IDEs",
   "main": "mcp-client.js",
   "bin": {