@i18n-agent/mcp-client 1.7.8 → 1.8.0

package/README.md

@@ -13,7 +13,7 @@ Professional translation service client for Claude, Cursor, VS Code, and other A
 - **🔄 Timeout Improvements**: Extended timeouts (5-10 min) for large translations
 - **📊 Progress Tracking**: Real-time job status and completion monitoring
 - **💰 Credit Tracking**: Real-time credit balance and word count estimates
-- **🌐 30+ Languages**: Multi-tier language support with quality ratings
+- **🌐 48 Languages**: Comprehensive language support with regional variants
 - **🔧 Easy Setup**: One-command installation for major AI IDEs
 
 ## 🚀 Quick Installation
@@ -71,7 +71,7 @@ List supported languages with quality ratings
 
 ### Content Analysis
 ```
-Analyze content for translation readiness and get improvement suggestions
+Analyze "Hello world! This is a test." for translation to Spanish
 ```
 
 ## 🛠 Supported AI IDEs
@@ -83,41 +83,54 @@ Analyze content for translation readiness and get improvement suggestions
 | **VS Code** | ✅ Auto-configured | `~/.vscode/mcp_settings.json` |
 | **Other MCP IDEs** | 🔧 Manual setup | Varies |
 
-## 🌐 Language Support
-- **en**: English
-- **fr**: French
+## 🌐 Language Support (48 Languages)
+- **bg**: Bulgarian
+- **ca**: Catalan
+- **cs**: Czech
+- **da**: Danish
 - **de**: German
+- **el**: Greek
+- **en**: English
+- **en-AU**: English (Australia)
+- **en-CA**: English (Canada)
+- **en-GB**: English (United Kingdom)
+- **en-US**: English (United States)
 - **es**: Spanish
+- **es-MX**: Spanish (Mexico)
+- **et**: Estonian
+- **fi**: Finnish
+- **fr**: French
+- **fr-CA**: French (Canada)
+- **hi**: Hindi
+- **hr**: Croatian
+- **hu**: Hungarian
+- **id**: Indonesian
+- **is**: Icelandic
 - **it**: Italian
-- **pt**: Portuguese
-- **ru**: Russian
 - **ja**: Japanese
 - **ko**: Korean
-- **zh-CN**: Chinese (Simplified)
+- **lt**: Lithuanian
+- **lv**: Latvian
+- **ms**: Malay
 - **nl**: Dutch
-- **pl**: Polish
-- **cs**: Czech
-- **ar**: Arabic
-- **he**: Hebrew
-- **hi**: Hindi
-- **zh-TW**: Chinese (Traditional)
-- **sv**: Swedish
-- **da**: Danish
 - **no**: Norwegian
-- **fi**: Finnish
-- **tr**: Turkish
-- **hu**: Hungarian
-- **th**: Thai
-- **vi**: Vietnamese
-- **uk**: Ukrainian
-- **bg**: Bulgarian
+- **pl**: Polish
+- **pt**: Portuguese
+- **pt-BR**: Portuguese (Brazil)
 - **ro**: Romanian
-- **hr**: Croatian
+- **ru**: Russian
 - **sk**: Slovak
 - **sl**: Slovenian
-- **et**: Estonian
-- **lv**: Latvian
-- **lt**: Lithuanian
+- **sr**: Serbian
+- **sv**: Swedish
+- **th**: Thai
+- **tl**: Filipino
+- **tr**: Turkish
+- **uk**: Ukrainian
+- **vi**: Vietnamese
+- **zh-Hans**: Chinese (Simplified)
+- **zh-Hant-HK**: Chinese (Traditional, Hong Kong)
+- **zh-Hant-TW**: Chinese (Traditional, Taiwan)
 
 ## 📁 Supported File Formats
 
@@ -128,8 +141,11 @@ Analyze content for translation readiness and get improvement suggestions
 | CSV | `.csv` | Handles quoted fields, commas |
 | XML/HTML | `.xml`, `.html` | Extracts text content |
 | Markdown | `.md` | Preserves formatting, skips code |
-| Properties | `.properties` | Key-value pairs |
+| Properties | `.properties` | Java properties key-value pairs |
 | Plain Text | `.txt` | Direct translation |
+| PDF | `.pdf` | Text extraction and translation |
+| Word | `.docx`, `.doc` | Document translation |
+| Gettext | `.po`, `.pot`, `.mo` | Localization file formats |
 
 ## 🔧 Manual Setup
 
@@ -347,7 +363,7 @@ Translate files while preserving structure and format.
 - `outputFormat` (string): Output format (same, json, yaml, txt)
 
 ### analyze_content
-Analyze content for translation readiness and get improvement suggestions before translation.
+Analyze content for translation readiness and get improvement suggestions before translation. This helps identify potential issues and optimize content before spending credits on translation.
 
 **Parameters:**
 - `content` (string/array/object): Content to analyze

package/install.js

@@ -41,9 +41,15 @@ Features:
 ✨ Text translation with cultural context
 📁 File translation (JSON, YAML, CSV, MD, etc.)
 💰 Credit balance checking
-🌐 30+ language support with quality tiers
+🌐 48 languages supported with regional variants
 `);
 
+const getMcpClientPaths = () => {
+  const mcpClientPath = path.resolve(__dirname, 'mcp-client.js');
+  const packageDir = path.dirname(mcpClientPath);
+  return { mcpClientPath, packageDir };
+};
+
 async function detectAvailableIDEs() {
   const available = [];
   
@@ -58,13 +64,14 @@ async function detectAvailableIDEs() {
 }
 
 function createMCPConfig() {
-  const mcpClientPath = path.resolve(__dirname, 'mcp-client.js');
-  
+  const { mcpClientPath, packageDir } = getMcpClientPaths();
+
   return {
     mcpServers: {
       "i18n-agent": {
         command: "node",
         args: [mcpClientPath],
+        cwd: packageDir,
         env: {
           MCP_SERVER_URL: "https://mcp.i18nagent.ai",
           API_KEY: ""
@@ -90,25 +97,27 @@ function detectNodeEnvironment() {
 function createWrapperScript(targetDir) {
   const nodeEnv = detectNodeEnvironment();
   const wrapperPath = path.join(targetDir, 'run-mcp.sh');
-  const mcpClientPath = path.join(targetDir, 'node_modules', '@i18n-agent', 'mcp-client', 'mcp-client.js');
-  
+  const { mcpClientPath, packageDir } = getMcpClientPaths();
+
+  fs.mkdirSync(targetDir, { recursive: true });
+
   let wrapperContent;
-  
+
   if (nodeEnv.isNvm) {
     // For nvm users, we need to set up the PATH properly
     wrapperContent = `#!/bin/bash
 # Wrapper script for i18n-agent MCP client (handles nvm environments)
 export PATH="${path.dirname(nodeEnv.nodePath)}:$PATH"
-cd "${targetDir}"
+cd "${packageDir}"
 exec node "${mcpClientPath}"`;
   } else {
     // For system node installations
     wrapperContent = `#!/bin/bash
 # Wrapper script for i18n-agent MCP client
-cd "${targetDir}"
+cd "${packageDir}"
 exec node "${mcpClientPath}"`;
   }
-  
+
   fs.writeFileSync(wrapperPath, wrapperContent, { mode: 0o755 });
   return wrapperPath;
 }
@@ -139,7 +148,7 @@ function updateClaudeConfig(configPath) {
     // Create wrapper script for nvm users
     console.log('   🔧 Detected nvm environment, creating wrapper script...');
     const wrapperPath = createWrapperScript(claudeDir);
-    
+
     config.mcpServers["i18n-agent"] = {
       command: wrapperPath,
       env: {
@@ -149,17 +158,8 @@ function updateClaudeConfig(configPath) {
     };
   } else {
     // Standard configuration for system node
-    const mcpClientPath = path.join(claudeDir, 'node_modules', '@i18n-agent', 'mcp-client', 'mcp-client.js');
-    
-    config.mcpServers["i18n-agent"] = {
-      command: "node",
-      args: [mcpClientPath],
-      cwd: claudeDir,
-      env: {
-        MCP_SERVER_URL: "https://mcp.i18nagent.ai",
-        API_KEY: ""
-      }
-    };
+    const baseConfig = createMCPConfig();
+    config.mcpServers["i18n-agent"] = baseConfig.mcpServers["i18n-agent"];
   }
   
   // Write updated config
@@ -170,12 +170,28 @@ function updateClaudeConfig(configPath) {
 }
 
 function updateGenericMCPConfig(configPath) {
-  const config = createMCPConfig();
-  
+  let config = {};
+
+  if (fs.existsSync(configPath)) {
+    try {
+      const existing = fs.readFileSync(configPath, 'utf8');
+      config = JSON.parse(existing);
+    } catch (error) {
+      console.warn(`Warning: Could not parse existing config at ${configPath}`);
+    }
+  }
+
+  if (!config.mcpServers) {
+    config.mcpServers = {};
+  }
+
+  const baseConfig = createMCPConfig();
+  config.mcpServers["i18n-agent"] = baseConfig.mcpServers["i18n-agent"];
+
   // Write config
   fs.mkdirSync(path.dirname(configPath), { recursive: true });
   fs.writeFileSync(configPath, JSON.stringify(config, null, 2));
-  
+
   return config;
 }
 
@@ -274,4 +290,4 @@ if (import.meta.url === `file://${process.argv[1]}`) {
   main();
 }
 
-export { main, IDE_CONFIGS, createMCPConfig };
+export { main, IDE_CONFIGS, createMCPConfig };

package/mcp-client.js

@@ -5,7 +5,7 @@
  * Integrates with Claude Code CLI to provide translation capabilities
  */
 
-const MCP_CLIENT_VERSION = '1.7.8';
+const MCP_CLIENT_VERSION = '1.8.0';
 
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
@@ -117,8 +117,8 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
             },
             fileType: {
               type: 'string',
-              description: 'File type: json, yaml, yml, xml, csv, txt, md, html, properties',
-              enum: ['json', 'yaml', 'yml', 'xml', 'csv', 'txt', 'md', 'html', 'properties', 'auto'],
+              description: 'File type: json, yaml, yml, xml, csv, txt, md, html, properties (Java), pdf, docx, doc, po (gettext), pot (gettext), mo (gettext), auto',
+              enum: ['json', 'yaml', 'yml', 'xml', 'csv', 'txt', 'md', 'html', 'properties', 'pdf', 'docx', 'doc', 'po', 'pot', 'mo', 'auto'],
               default: 'auto',
             },
             targetLanguages: {
@@ -164,6 +164,46 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
           required: ['targetLanguages'],
         },
       },
+      {
+        name: 'analyze_content',
+        description: 'Analyze content for translation readiness and get improvement suggestions. Returns detailed analysis including content type, quality score, and specific recommendations. Costs the same credits as translation.',
+        inputSchema: {
+          type: 'object',
+          properties: {
+            content: {
+              type: ['string', 'array', 'object'],
+              description: 'Content to analyze (text string, array of texts, or structured object)',
+            },
+            fileType: {
+              type: 'string',
+              description: 'Optional file type if content is from a file (json, yaml, xml, etc.)',
+            },
+            sourceLanguage: {
+              type: 'string',
+              description: 'Source language code (auto-detected if not provided)',
+            },
+            targetLanguage: {
+              type: 'string',
+              description: 'Target language code for translation',
+            },
+            industry: {
+              type: 'string',
+              description: 'Industry context (e.g., "technology", "healthcare", "finance")',
+              default: 'general',
+            },
+            targetAudience: {
+              type: 'string',
+              description: 'Target audience (e.g., "general", "technical", "professional")',
+              default: 'general',
+            },
+            region: {
+              type: 'string',
+              description: 'Specific region for localization (e.g., "Spain", "Mexico", "Brazil")',
+            },
+          },
+          required: ['content', 'targetLanguage'],
+        },
+      },
       {
         name: 'get_credits',
         description: 'Get remaining credits for the user and approximate word count available at 0.001 credits per word',
@@ -265,15 +305,18 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
       case 'translate_file':
         return await handleTranslateFile(args);
       
+      case 'analyze_content':
+        return await handleAnalyzeContent(args);
+
       case 'get_credits':
         return await handleGetCredits(args);
-      
+
       /*
        * TOKEN USAGE TOOLS - BLOCKED FOR SECURITY
        * These cases are intentionally removed to prevent access to sensitive analytics data
        * through MCP interfaces. See tool definition comments above for details.
        */
-      
+
       case 'check_translation_status':
         return await handleCheckTranslationStatus(args);
 
@@ -911,10 +954,86 @@ async function pollTranslationJob(jobId, estimatedTime) {
   throw new Error(`Translation job ${jobId} timed out after ${maxPolls * pollInterval / 1000} seconds. Please retry with a smaller chunk or split the content into multiple requests.`);
 }
 
+async function handleAnalyzeContent(args) {
+  const {
+    content,
+    fileType,
+    sourceLanguage,
+    targetLanguage,
+    industry = 'general',
+    targetAudience = 'general',
+    region
+  } = args;
+
+  if (!content) {
+    throw new Error('content is required');
+  }
+
+  if (!targetLanguage) {
+    throw new Error('targetLanguage is required');
+  }
+
+  // Use MCP JSON-RPC protocol for analyze_content
+  const mcpRequest = {
+    jsonrpc: '2.0',
+    id: Date.now(),
+    method: 'tools/call',
+    params: {
+      name: 'analyze_content',
+      arguments: {
+        apiKey: API_KEY,
+        content,
+        fileType,
+        sourceLanguage,
+        targetLanguage,
+        industry,
+        targetAudience,
+        region
+      }
+    }
+  };
+
+  try {
+    const response = await axios.post(MCP_SERVER_URL, mcpRequest, {
+      headers: {
+        'Content-Type': 'application/json',
+      },
+      timeout: 60000, // 1 minute timeout for analysis
+    });
+
+    if (response.data.error) {
+      const errorMsg = response.data.error.message || response.data.error;
+      throw new Error(`Content analysis error: ${errorMsg}`);
+    }
+
+    return response.data.result;
+  } catch (error) {
+    // Handle 401 unauthorized
+    if (error.response?.status === 401) {
+      const authErrorDetails = error.response.data?.message || error.response.data?.result?.content?.[0]?.text || error.message;
+      throw new Error(`❌ Invalid API key (401)\nDetails: ${authErrorDetails}\nPlease check your API key at https://app.i18nagent.ai\n[MCP v${MCP_CLIENT_VERSION}/STDIO/analyze_content]`);
+    }
+
+    // Handle 402 payment required
+    if (error.response?.status === 402) {
+      const creditErrorDetails = error.response.data?.message || error.response.data?.result?.content?.[0]?.text || error.message;
+      throw new Error(`⚠️ Insufficient credits (402)\nDetails: ${creditErrorDetails}\nPlease top up at https://app.i18nagent.ai\n[MCP v${MCP_CLIENT_VERSION}/STDIO/analyze_content]`);
+    }
+
+    // Handle 503 service unavailable
+    if (error.response?.status === 503) {
+      throw new Error(`i18n-agent encountered unexpected problem, and we are working on it, try again later.`);
+    }
+
+    console.error('Content analysis error:', error);
+    throw new Error(`Unable to analyze content: ${error.message}`);
+  }
+}
+
 async function handleGetCredits(args) {
   const { apiKey } = args;
   const creditsApiKey = apiKey || API_KEY;
-  
+
   // Use MCP JSON-RPC protocol for get_credits
   const mcpRequest = {
     jsonrpc: '2.0',
@@ -927,7 +1046,7 @@ async function handleGetCredits(args) {
       }
     }
   };
-  
+
   try {
     const response = await axios.post(MCP_SERVER_URL, mcpRequest, {
       headers: {
@@ -938,13 +1057,13 @@ async function handleGetCredits(args) {
 
     if (response.data.error) {
       const errorMsg = response.data.error.message || response.data.error;
-      const isAuthError = errorMsg.toString().toLowerCase().includes('api key') || 
+      const isAuthError = errorMsg.toString().toLowerCase().includes('api key') ||
                          errorMsg.toString().toLowerCase().includes('api_key') ||
                          errorMsg.toString().toLowerCase().includes('unauthorized');
-      const isCreditError = errorMsg.toString().toLowerCase().includes('credit') || 
+      const isCreditError = errorMsg.toString().toLowerCase().includes('credit') ||
                            errorMsg.toString().toLowerCase().includes('quota') ||
                            errorMsg.toString().toLowerCase().includes('limit exceeded');
-      
+
       let finalErrorMsg = `Credits service error: ${errorMsg}`;
       if (!isAuthError && !isCreditError) {
         finalErrorMsg += `. Please check the service status or contact support.`;
@@ -955,12 +1074,12 @@ async function handleGetCredits(args) {
     const result = response.data.result;
     if (result && result.content && result.content[0]) {
       const textContent = result.content[0].text;
-      
+
       // Try to parse as JSON for structured data
       try {
         const parsed = JSON.parse(textContent);
         const approximateWordsAvailable = parsed.credits ? Math.floor(parsed.credits * 1000) : 0;
-        
+
         return {
           content: [
             {
@@ -979,7 +1098,7 @@ async function handleGetCredits(args) {
         return result;
       }
     }
-    
+
     return result;
   } catch (error) {
     // Handle 401 unauthorized
@@ -987,7 +1106,7 @@ async function handleGetCredits(args) {
       const creditsAuthErrorDetails = error.response.data?.message || error.response.data?.result?.content?.[0]?.text || error.message;
       throw new Error(`❌ Invalid API key (401)\nDetails: ${creditsAuthErrorDetails}\nPlease check your API key at https://app.i18nagent.ai\n[MCP v${MCP_CLIENT_VERSION}/STDIO/get_credits]`);
     }
-    
+
     console.error('Credits check error:', error);
     throw new Error(`Unable to check credits: ${error.message}`);
   }
@@ -1469,7 +1588,10 @@ async function handleDownloadTranslations(args) {
     method: 'tools/call',
     params: {
       name: 'download_translations',
-      arguments: { jobId }
+      arguments: {
+        apiKey: API_KEY,
+        jobId
+      }
     }
   };
 

package/package.json

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