@i18n-agent/mcp-client 1.8.17 → 1.8.19

package/install.js

@@ -184,7 +184,8 @@ function createMCPConfig() {
         env: {
           MCP_SERVER_URL: "https://mcp.i18nagent.ai",
           API_KEY: ""
-        }
+        },
+        disabled: false
       }
     }
   };
@@ -272,7 +273,8 @@ function updateClaudeConfig(configPath, ideKey = 'claude') {
         env: {
           MCP_SERVER_URL: "https://mcp.i18nagent.ai",
           API_KEY: existingApiKey || ""
-        }
+        },
+        disabled: false
       };
     } else {
       // For system node, use 'node' with args
@@ -294,7 +296,8 @@ function updateClaudeConfig(configPath, ideKey = 'claude') {
         env: {
           MCP_SERVER_URL: "https://mcp.i18nagent.ai",
           API_KEY: existingApiKey || ""
-        }
+        },
+        disabled: false
       };
     } else {
       const baseConfig = createMCPConfig();
@@ -350,7 +353,8 @@ function updateGenericMCPConfig(configPath) {
       env: {
         MCP_SERVER_URL: "https://mcp.i18nagent.ai",
         API_KEY: existingApiKey || ""
-      }
+      },
+      disabled: false
     };
   } else {
     const baseConfig = createMCPConfig();
@@ -402,7 +406,8 @@ function updateClaudeJsonConfig(configPath) {
       env: {
         MCP_SERVER_URL: "https://mcp.i18nagent.ai",
         API_KEY: existingApiKey || ""
-      }
+      },
+      disabled: false
     };
   } else {
     config.mcpServers["i18n-agent"] = {
@@ -411,7 +416,8 @@ function updateClaudeJsonConfig(configPath) {
       env: {
         MCP_SERVER_URL: "https://mcp.i18nagent.ai",
         API_KEY: existingApiKey || ""
-      }
+      },
+      disabled: false
     };
   }
 

package/mcp-client.js

@@ -5,7 +5,7 @@
  * Integrates with Claude Code CLI to provide translation capabilities
  */
 
-const MCP_CLIENT_VERSION = '1.8.17';
+const MCP_CLIENT_VERSION = '1.8.19';
 
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
@@ -47,7 +47,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
     tools: [
       {
         name: 'translate_text',
-        description: '⚠️ CRITICAL: For multi-language translation, use targetLanguages parameter (not targetLanguage). Translate text content with cultural adaptation using AI subagents. Supports both single and multi-language translation. For large requests (>100 texts or >50,000 characters), returns a jobId for async processing. Use check_translation_status to monitor progress and download results.',
+        description: '⚠️ CRITICAL: For multi-language translation, use targetLanguages parameter (not targetLanguage). Translate text content with cultural adaptation using AI subagents. Supports both single and multi-language translation. For large requests (>100 texts or >50,000 characters), returns a jobId for async processing. Use check_translation_status to monitor progress and download results. Set pseudoTranslation=true for testing i18n implementations without AI cost.',
         inputSchema: {
           type: 'object',
           properties: {
@@ -83,6 +83,36 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
               type: 'string',
               description: 'Optional additional context or instructions for the translation (e.g., "Keep technical terms in English", "Use formal tone")',
             },
+            pseudoTranslation: {
+              type: 'boolean',
+              description: 'Enable pseudo-translation mode for testing i18n implementations (bypasses AI translation, no credit cost)',
+            },
+            pseudoOptions: {
+              type: 'object',
+              properties: {
+                addCJK: {
+                  type: 'boolean',
+                  description: 'Add CJK characters to test wide character support',
+                },
+                expansionRatio: {
+                  type: 'number',
+                  description: 'Length expansion ratio (1.0 = no expansion, 1.3 = 30% longer, 2.0 = double length)',
+                },
+                addSpecialChars: {
+                  type: 'boolean',
+                  description: 'Add special characters to test encoding/escaping',
+                },
+                addBrackets: {
+                  type: 'boolean',
+                  description: 'Wrap strings with brackets to identify untranslated content',
+                },
+                addAccents: {
+                  type: 'boolean',
+                  description: 'Replace Latin characters with accented equivalents',
+                },
+              },
+              description: 'Configuration options for pseudo-translation',
+            },
           },
           required: ['texts', 'targetLanguages'],
         },
@@ -103,7 +133,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
       },
       {
         name: 'translate_file',
-        description: '⚠️ CRITICAL: For multi-language translation, use targetLanguages parameter (not targetLanguage). Translate file content while preserving structure and format. Supports both single and multi-language translation. Supports JSON, YAML, XML, CSV, TXT, MD, and other text files. For large files (>100KB), returns a jobId for async processing. Use check_translation_status to monitor progress and download results.',
+        description: '⚠️ CRITICAL: For multi-language translation, use targetLanguages parameter (not targetLanguage). Translate file content while preserving structure and format. Supports both single and multi-language translation. Supports JSON, YAML, XML, CSV, TXT, MD, and other text files. For large files (>100KB), returns a jobId for async processing. Use check_translation_status to monitor progress and download results. Set pseudoTranslation=true for testing i18n implementations without AI cost.',
         inputSchema: {
           type: 'object',
           properties: {
@@ -160,6 +190,36 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
               type: 'string',
               description: 'Optional additional context or instructions for the translation (e.g., "Keep technical terms in English", "Use formal tone")',
             },
+            pseudoTranslation: {
+              type: 'boolean',
+              description: 'Enable pseudo-translation mode for testing i18n implementations (bypasses AI translation, no credit cost)',
+            },
+            pseudoOptions: {
+              type: 'object',
+              properties: {
+                addCJK: {
+                  type: 'boolean',
+                  description: 'Add CJK characters to test wide character support',
+                },
+                expansionRatio: {
+                  type: 'number',
+                  description: 'Length expansion ratio (1.0 = no expansion, 1.3 = 30% longer, 2.0 = double length)',
+                },
+                addSpecialChars: {
+                  type: 'boolean',
+                  description: 'Add special characters to test encoding/escaping',
+                },
+                addBrackets: {
+                  type: 'boolean',
+                  description: 'Wrap strings with brackets to identify untranslated content',
+                },
+                addAccents: {
+                  type: 'boolean',
+                  description: 'Replace Latin characters with accented equivalents',
+                },
+              },
+              description: 'Configuration options for pseudo-translation',
+            },
           },
           required: ['targetLanguages'],
         },
@@ -376,7 +436,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
 });
 
 async function handleTranslateText(args) {
-  const { texts, targetLanguages: rawTargetLanguages, sourceLanguage, targetAudience = 'general', industry = 'technology', region, context } = args;
+  const { texts, targetLanguages: rawTargetLanguages, sourceLanguage, targetAudience = 'general', industry = 'technology', region, context, pseudoTranslation, pseudoOptions } = args;
 
   if (!texts || !Array.isArray(texts) || texts.length === 0) {
     throw new Error('texts must be a non-empty array');
@@ -420,6 +480,8 @@ async function handleTranslateText(args) {
         industry: industry,
         region: region,
         context: context,
+        pseudoTranslation: pseudoTranslation,
+        pseudoOptions: pseudoOptions,
       }
     }
   };
@@ -684,7 +746,9 @@ async function handleTranslateFile(args) {
     outputFormat = 'same',
     sourceLanguage,
     region,
-    context
+    context,
+    pseudoTranslation,
+    pseudoOptions
   } = args;
 
   if (!filePath && !fileContent) {
@@ -740,6 +804,8 @@ async function handleTranslateFile(args) {
   if (targetLanguages !== undefined) requestArgs.targetLanguages = targetLanguages;
   if (region !== undefined) requestArgs.region = region;
   if (context !== undefined) requestArgs.context = context;
+  if (pseudoTranslation !== undefined) requestArgs.pseudoTranslation = pseudoTranslation;
+  if (pseudoOptions !== undefined) requestArgs.pseudoOptions = pseudoOptions;
 
   // Use MCP JSON-RPC protocol for translate_file
   const mcpRequest = {
@@ -1630,11 +1696,8 @@ async function handleDownloadTranslations(args) {
       parsedResult = result;
     }
 
-    if (!parsedResult.success) {
-      throw new Error(parsedResult.error || 'Failed to get download URLs');
-    }
-
-    // Step 2: Download files from URLs and write to local /tmp
+    // Detect storage type and handle accordingly
+    const storageType = parsedResult.storageType || 'local';
     const outputDir = `/tmp/i18n-translations-${jobId}`;
 
     // Create output directory
@@ -1642,40 +1705,65 @@ async function handleDownloadTranslations(args) {
       fs.mkdirSync(outputDir, { recursive: true });
     }
 
-    const downloadUrls = parsedResult.downloadUrls;
-    if (!downloadUrls || downloadUrls.length === 0) {
-      throw new Error('No download URLs provided by server');
-    }
-
     const filesWritten = [];
 
-    // Download each language file
-    for (const { language, url } of downloadUrls) {
-      try {
-        console.error(`📥 Downloading ${language}...`);
+    if (storageType === 's3' && parsedResult.downloadUrls) {
+      // Case 1: S3 Storage - download files from presigned URLs
+      console.error(`📥 Downloading ${Object.keys(parsedResult.downloadUrls).length} translation files from S3...`);
 
-        const fileResponse = await axios.get(url, {
-          responseType: 'text',
-          timeout: 60000, // 1 minute per file
-          headers: {
-            'Authorization': `Bearer ${API_KEY}`
-          }
-        });
+      for (const [language, urlInfo] of Object.entries(parsedResult.downloadUrls)) {
+        try {
+          console.error(`📥 Downloading ${language}...`);
+
+          const fileResponse = await axios.get(urlInfo.url, {
+            responseType: 'text',
+            timeout: 60000, // 1 minute per file
+            headers: {
+              'Authorization': `Bearer ${API_KEY}`
+            }
+          });
 
-        // Determine file extension from metadata
-        const fileType = parsedResult.metadata?.fileType || 'json';
-        const fileName = `${language}.${fileType}`;
-        const filePath = path.join(outputDir, fileName);
+          // Determine file extension from file name or metadata
+          const fileType = parsedResult.fileName?.split('.').pop() || 'json';
+          const fileName = `${language}.${fileType}`;
+          const filePath = path.join(outputDir, fileName);
 
-        // Write file to disk
-        fs.writeFileSync(filePath, fileResponse.data, 'utf8');
-        filesWritten.push(filePath);
+          // Write file to disk
+          fs.writeFileSync(filePath, fileResponse.data, 'utf8');
+          filesWritten.push(filePath);
 
-        console.error(`✅ Downloaded ${fileName}`);
-      } catch (downloadError) {
-        console.error(`❌ Failed to download ${language}:`, downloadError.message);
-        throw new Error(`Failed to download ${language}: ${downloadError.message}`);
+          console.error(`✅ Downloaded ${fileName}`);
+        } catch (downloadError) {
+          console.error(`❌ Failed to download ${language}:`, downloadError.message);
+          throw new Error(`Failed to download ${language}: ${downloadError.message}`);
+        }
       }
+    } else if (parsedResult.translations) {
+      // Case 2: Raw Translations - write directly from response
+      console.error(`💾 Writing ${Object.keys(parsedResult.translations).length} translation files from raw content...`);
+
+      for (const [language, content] of Object.entries(parsedResult.translations)) {
+        try {
+          console.error(`💾 Writing ${language}...`);
+
+          // Determine file extension from file name or default to json
+          const fileType = parsedResult.fileName?.split('.').pop() || 'json';
+          const fileName = `${language}.${fileType}`;
+          const filePath = path.join(outputDir, fileName);
+
+          // Write file to disk
+          fs.writeFileSync(filePath, content, 'utf8');
+          filesWritten.push(filePath);
+
+          console.error(`✅ Wrote ${fileName}`);
+        } catch (writeError) {
+          console.error(`❌ Failed to write ${language}:`, writeError.message);
+          throw new Error(`Failed to write ${language}: ${writeError.message}`);
+        }
+      }
+    } else {
+      // No valid download method found
+      throw new Error(`No translations available. Storage type: ${storageType}. Expected either downloadUrls (S3) or translations (raw content).`);
     }
 
     // Return success with file paths
@@ -1687,8 +1775,10 @@ async function handleDownloadTranslations(args) {
           jobId,
           outputDirectory: outputDir,
           filesWritten,
-          metadata: parsedResult.metadata,
-          message: `✅ Downloaded ${filesWritten.length} translation files to ${outputDir}`
+          storageType,
+          fileName: parsedResult.fileName,
+          targetLanguages: parsedResult.targetLanguages,
+          message: `✅ ${storageType === 's3' ? 'Downloaded' : 'Wrote'} ${filesWritten.length} translation files to ${outputDir}`
         }, null, 2)
       }]
     };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@i18n-agent/mcp-client",
-  "version": "1.8.17",
+  "version": "1.8.19",
   "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": {