@i18n-agent/mcp-client 1.8.18 → 1.8.20

package/README.md

@@ -346,6 +346,7 @@ Translate text content with cultural adaptation and context awareness.
 - `targetLanguage` (string): Target language code
 - `targetAudience` (string): Target audience context
 - `industry` (string): Industry context
+- `namespace` (string, **required**): Unique namespace identifier for backend tracking and project organization
 - `sourceLanguage` (string, optional): Source language (auto-detected if not provided)
 - `region` (string, optional): Specific region for localization
 
@@ -356,6 +357,7 @@ Translate files while preserving structure and format.
 - `filePath` or `fileContent` (string): File path or content to translate
 - `fileType` (string): File format (json, yaml, xml, csv, txt, md, etc.)
 - `targetLanguage` (string): Target language code
+- `namespace` (string, **required**): Unique namespace identifier for backend tracking and project organization
 - `preserveKeys` (boolean): Whether to preserve object keys/structure
 - `outputFormat` (string): Output format (same, json, yaml, txt)
 

package/mcp-client.js

@@ -5,7 +5,7 @@
  * Integrates with Claude Code CLI to provide translation capabilities
  */
 
-const MCP_CLIENT_VERSION = '1.8.18';
+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,8 +83,42 @@ 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',
+            },
+            namespace: {
+              type: 'string',
+              description: 'Unique namespace identifier for backend tracking and project organization (required for production use)',
+            },
           },
-          required: ['texts', 'targetLanguages'],
+          required: ['texts', 'targetLanguages', 'namespace'],
         },
       },
       {
@@ -103,7 +137,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,8 +194,42 @@ 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',
+            },
+            namespace: {
+              type: 'string',
+              description: 'Unique namespace identifier for backend tracking and project organization (required for production use)',
+            },
           },
-          required: ['targetLanguages'],
+          required: ['targetLanguages', 'namespace'],
         },
       },
       {
@@ -376,12 +444,16 @@ 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, namespace } = args;
 
   if (!texts || !Array.isArray(texts) || texts.length === 0) {
     throw new Error('texts must be a non-empty array');
   }
 
+  if (!namespace) {
+    throw new Error('namespace is required for translation tracking and project organization');
+  }
+
   // Normalize targetLanguages - accept both string and array
   let targetLanguages = rawTargetLanguages;
   let targetLanguage = undefined;
@@ -420,6 +492,9 @@ async function handleTranslateText(args) {
         industry: industry,
         region: region,
         context: context,
+        pseudoTranslation: pseudoTranslation,
+        pseudoOptions: pseudoOptions,
+        namespace: namespace,
       }
     }
   };
@@ -684,13 +759,20 @@ async function handleTranslateFile(args) {
     outputFormat = 'same',
     sourceLanguage,
     region,
-    context
+    context,
+    pseudoTranslation,
+    pseudoOptions,
+    namespace
   } = args;
 
   if (!filePath && !fileContent) {
     throw new Error('Either filePath or fileContent must be provided');
   }
 
+  if (!namespace) {
+    throw new Error('namespace is required for translation tracking and project organization');
+  }
+
   // Normalize targetLanguages - accept both string and array
   let targetLanguages = rawTargetLanguages;
   let targetLanguage = undefined;
@@ -732,7 +814,8 @@ async function handleTranslateFile(args) {
     targetAudience,
     industry,
     preserveKeys,
-    outputFormat
+    outputFormat,
+    namespace
   };
 
   // Add optional parameters only if defined
@@ -740,6 +823,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 = {
@@ -915,7 +1000,7 @@ async function pollTranslationJob(jobId, estimatedTime) {
       
       const response = await axios.post(MCP_SERVER_URL, statusRequest, {
         headers: { 'Content-Type': 'application/json' },
-        timeout: 10000
+        timeout: 30000
       });
       
       if (response.data.error) {

package/package.json

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