@i18n-agent/mcp-client 1.7.4 → 1.7.5

package/mcp-client.js

@@ -5,7 +5,7 @@
  * Integrates with Claude Code CLI to provide translation capabilities
  */
 
-const MCP_CLIENT_VERSION = '1.7.4';
+const MCP_CLIENT_VERSION = '1.7.5';
 
 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: '⚠️ IMPORTANT: You MUST provide either targetLanguage (for single language) OR targetLanguages array (for multiple languages). 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.',
         inputSchema: {
           type: 'object',
           properties: {
@@ -56,14 +56,12 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
               items: { type: 'string' },
               description: 'Array of source texts to translate (any language)',
             },
-            targetLanguage: {
-              type: 'string',
-              description: '⚠️ REQUIRED (if targetLanguages not provided): Target language code for single language translation (e.g., "es", "fr", "zh-CN")',
-            },
             targetLanguages: {
-              type: 'array',
-              items: { type: 'string' },
-              description: '⚠️ REQUIRED (if targetLanguage not provided): Array of target language codes for multi-language translation (e.g., ["es", "fr", "zh-CN"])',
+              description: '⚠️ REQUIRED: Target language(s) - can be a single string (e.g., "es") OR an array of strings (e.g., ["es", "fr", "zh-CN"]) for multi-language translation',
+              oneOf: [
+                { type: 'string' },
+                { type: 'array', items: { type: 'string' } }
+              ]
             },
             sourceLanguage: {
               type: 'string',
@@ -86,7 +84,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
               description: 'Optional additional context or instructions for the translation (e.g., "Keep technical terms in English", "Use formal tone")',
             },
           },
-          required: ['texts'],
+          required: ['texts', 'targetLanguages'],
         },
       },
       {
@@ -105,7 +103,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
       },
       {
         name: 'translate_file',
-        description: '⚠️ IMPORTANT: You MUST provide either targetLanguage (for single language) OR targetLanguages array (for multiple languages). 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.',
         inputSchema: {
           type: 'object',
           properties: {
@@ -123,14 +121,12 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
               enum: ['json', 'yaml', 'yml', 'xml', 'csv', 'txt', 'md', 'html', 'properties', 'auto'],
               default: 'auto',
             },
-            targetLanguage: {
-              type: 'string',
-              description: '⚠️ REQUIRED (if targetLanguages not provided): Target language code or name - for single language translation (e.g., "es", "fr", "de")',
-            },
             targetLanguages: {
-              type: 'array',
-              items: { type: 'string' },
-              description: '⚠️ REQUIRED (if targetLanguage not provided): Array of target language codes for multi-language translation (e.g., ["es", "fr", "zh-CN"])',
+              description: '⚠️ REQUIRED: Target language(s) - can be a single string (e.g., "es") OR an array of strings (e.g., ["es", "fr", "zh-CN"]) for multi-language translation',
+              oneOf: [
+                { type: 'string' },
+                { type: 'array', items: { type: 'string' } }
+              ]
             },
             targetAudience: {
               type: 'string',
@@ -165,7 +161,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
               description: 'Optional additional context or instructions for the translation (e.g., "Keep technical terms in English", "Use formal tone")',
             },
           },
-          required: [],
+          required: ['targetLanguages'],
         },
       },
       {
@@ -289,20 +285,27 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
 });
 
 async function handleTranslateText(args) {
-  const { texts, targetLanguage, targetLanguages, sourceLanguage, targetAudience = 'general', industry = 'technology', region, context } = args;
+  const { texts, targetLanguages: rawTargetLanguages, sourceLanguage, targetAudience = 'general', industry = 'technology', region, context } = args;
 
   if (!texts || !Array.isArray(texts) || texts.length === 0) {
     throw new Error('texts must be a non-empty array');
   }
 
-  // Support both single and multi-language: targetLanguage OR targetLanguages
-  if (!targetLanguage && !targetLanguages?.length) {
-    throw new Error('Either targetLanguage or targetLanguages must be provided');
+  // Normalize targetLanguages - accept both string and array
+  let targetLanguages = rawTargetLanguages;
+  let targetLanguage = undefined;
+
+  if (typeof rawTargetLanguages === 'string') {
+    // Single language provided as string - convert to array for internal processing
+    targetLanguages = [rawTargetLanguages];
+    targetLanguage = rawTargetLanguages;
+  } else if (Array.isArray(rawTargetLanguages) && rawTargetLanguages.length === 1) {
+    // Single language provided as array - extract for backward compatibility
+    targetLanguage = rawTargetLanguages[0];
   }
 
-  // Ensure both are not provided at the same time
-  if (targetLanguage && targetLanguages?.length) {
-    throw new Error('Cannot specify both targetLanguage and targetLanguages');
+  if (!targetLanguages?.length) {
+    throw new Error('targetLanguages parameter is required (can be a string for single language or array for multiple languages)');
   }
 
   // Check if this is a large translation request
@@ -578,8 +581,7 @@ async function handleTranslateFile(args) {
     filePath,
     fileContent,
     fileType = 'auto',
-    targetLanguage,
-    targetLanguages,
+    targetLanguages: rawTargetLanguages,
     targetAudience = 'general',
     industry = 'technology',
     preserveKeys = true,
@@ -593,14 +595,21 @@ async function handleTranslateFile(args) {
     throw new Error('Either filePath or fileContent must be provided');
   }
 
-  // Support both single and multi-language: targetLanguage OR targetLanguages
-  if (!targetLanguage && !targetLanguages?.length) {
-    throw new Error('Either targetLanguage or targetLanguages must be provided');
+  // Normalize targetLanguages - accept both string and array
+  let targetLanguages = rawTargetLanguages;
+  let targetLanguage = undefined;
+
+  if (typeof rawTargetLanguages === 'string') {
+    // Single language provided as string - convert to array for internal processing
+    targetLanguages = [rawTargetLanguages];
+    targetLanguage = rawTargetLanguages;
+  } else if (Array.isArray(rawTargetLanguages) && rawTargetLanguages.length === 1) {
+    // Single language provided as array - extract for backward compatibility
+    targetLanguage = rawTargetLanguages[0];
   }
 
-  // Ensure both are not provided at the same time
-  if (targetLanguage && targetLanguages?.length) {
-    throw new Error('Cannot specify both targetLanguage and targetLanguages');
+  if (!targetLanguages?.length) {
+    throw new Error('targetLanguages parameter is required (can be a string for single language or array for multiple languages)');
   }
 
   // Read file content if path provided and no content given

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@i18n-agent/mcp-client",
-  "version": "1.7.4",
+  "version": "1.7.5",
   "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",
   "main": "mcp-client.js",
   "bin": {