@i18n-agent/mcp-client 1.1.2 → 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 {
@@ -17,8 +19,6 @@ import axios from 'axios';
 import fs from 'fs';
 import path from 'path';
 
-const MCP_CLIENT_VERSION = '1.1.2';
-
 const server = new Server(
   {
     name: 'i18n-agent',
@@ -243,7 +243,6 @@ async function handleTranslateText(args) {
   };
 
   try {
-    console.error(`[MCP v${MCP_CLIENT_VERSION}/STDIO/translate_text] Request: ${texts.length} texts, ${totalChars} chars to ${MCP_SERVER_URL}`);
     const response = await axios.post(MCP_SERVER_URL, mcpRequest, {
       headers: {
         'Content-Type': 'application/json',
@@ -308,30 +307,47 @@ async function handleTranslateText(args) {
       };
     }
     
-    // Check for payment required 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_text]`);
+    }
+    
+    // Handle 402 payment required with user-friendly message
     if (error.response?.status === 402) {
-      console.error(`[MCP v${MCP_CLIENT_VERSION}/STDIO/translate_text] Payment required (402)`);
-      throw new Error(`⚠️ Insufficient credits. Please top up at https://app.i18nagent.ai [MCP v${MCP_CLIENT_VERSION}/STDIO]`);
+      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 (503, timeout, connection issues)
+    // 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) {
-      console.error(`[MCP v${MCP_CLIENT_VERSION}/STDIO/translate_text] Infrastructure error:`, {
-        code: error.code,
-        status: error.response?.status,
-        message: error.message,
-        url: MCP_SERVER_URL
-      });
-      throw new Error(`Translation service unavailable [MCP v${MCP_CLIENT_VERSION}/STDIO/translate_text]: ${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, 404, etc), add context but don't mark as unavailable
-    console.error(`[MCP v${MCP_CLIENT_VERSION}/STDIO/translate_text] Error:`, error.message);
-    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]`);
   }
 }
 
@@ -469,7 +485,6 @@ async function handleTranslateFile(args) {
   };
 
   try {
-    console.error(`[MCP v${MCP_CLIENT_VERSION}/STDIO/translate_file] Request: ${content?.length || 0} chars to ${MCP_SERVER_URL}`);
     const response = await axios.post(MCP_SERVER_URL, mcpRequest, {
       headers: {
         'Content-Type': 'application/json',
@@ -502,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: [
@@ -524,30 +541,50 @@ async function handleTranslateFile(args) {
       };
     }
     
-    // Check for payment required 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) {
-      console.error(`[MCP v${MCP_CLIENT_VERSION}/STDIO/translate_file] Payment required (402)`);
-      throw new Error(`⚠️ Insufficient credits. Please top up at https://app.i18nagent.ai [MCP v${MCP_CLIENT_VERSION}/STDIO]`);
+      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 actually a service unavailable error
+    // 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) {
-      console.error(`[MCP v${MCP_CLIENT_VERSION}/STDIO/translate_file] Infrastructure error:`, {
-        code: error.code,
-        status: error.response?.status,
-        message: error.message,
-        url: MCP_SERVER_URL
-      });
-      throw new Error(`Translation service unavailable [MCP v${MCP_CLIENT_VERSION}/STDIO/translate_file]: ${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, add context but don't mark as unavailable
-    console.error(`[MCP v${MCP_CLIENT_VERSION}/STDIO/translate_file] Error:`, error.message);
-    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]`);
   }
 }
 
@@ -627,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.2",
+  "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": {