@i18n-agent/mcp-client 1.8.237 → 1.8.239

package/README.md

@@ -211,6 +211,12 @@ Create `.cursor/mcp_settings.json` or `.vscode/mcp_settings.json`:
 - **Monitoring**: Check balance before large translations
 - **Estimates**: Get word count estimates before translation
 
+### Quality Warnings
+- **Source Analysis**: By default, source content is analyzed for quality issues before translation
+- **Skip Warnings**: Use `skipWarnings: true` to bypass warnings in automated workflows
+- **Trade-off**: Skipping warnings may reduce translation quality as potential issues aren't addressed
+- **Best Practice**: Keep warnings enabled (default) for production translations
+
 ## 🚨 Troubleshooting
 
 ### Installation Issues
@@ -349,6 +355,7 @@ Translate text content with cultural adaptation and context awareness.
 - `namespace` (string, optional): Optional 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
+- `skipWarnings` (boolean, optional): Skip source text quality warnings (default: false). ⚠️ WARNING: May hurt translation quality by bypassing source analysis. Only use when confident about content quality or in automated workflows.
 
 ### translate_file
 Translate files while preserving structure and format.
@@ -360,6 +367,7 @@ Translate files while preserving structure and format.
 - `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)
+- `skipWarnings` (boolean, optional): Skip source text quality warnings (default: false). ⚠️ WARNING: May hurt translation quality by bypassing source analysis. Only use when confident about content quality or in automated workflows.
 
 ### analyze_content
 Analyze content for translation readiness and get improvement suggestions before translation. This helps identify potential issues and optimize content before spending credits on translation.

package/mcp-client.js

@@ -5,7 +5,7 @@
  * Integrates with Claude Code CLI to provide translation capabilities
  */
 
-const MCP_CLIENT_VERSION = '1.8.19';
+const MCP_CLIENT_VERSION = '1.8.239';
 
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
@@ -118,6 +118,11 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
               type: 'string',
               description: 'Optional namespace identifier for backend tracking and project organization (recommended for file-based workflows)',
             },
+            skipWarnings: {
+              type: 'boolean',
+              description: '⚠️ Skip source text quality warnings and proceed with translation (default: false). WARNING: Enabling this may hurt translation quality as it bypasses source file analysis that identifies potential issues. Only use when you are confident about your source content quality or in automated workflows where warnings would block progress.',
+              default: false,
+            },
           },
           required: ['texts', 'targetLanguages'],
         },
@@ -229,6 +234,11 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
               type: 'string',
               description: 'Unique namespace identifier for backend tracking and project organization (required for production use)',
             },
+            skipWarnings: {
+              type: 'boolean',
+              description: '⚠️ Skip source text quality warnings and proceed with translation (default: false). WARNING: Enabling this may hurt translation quality as it bypasses source file analysis that identifies potential issues. Only use when you are confident about your source content quality or in automated workflows where warnings would block progress.',
+              default: false,
+            },
           },
           required: ['targetLanguages', 'namespace'],
         },
@@ -445,7 +455,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
 });
 
 async function handleTranslateText(args) {
-  const { texts, targetLanguages: rawTargetLanguages, sourceLanguage, targetAudience = 'general', industry = 'technology', region, context, pseudoTranslation, pseudoOptions, namespace } = args;
+  const { texts, targetLanguages: rawTargetLanguages, sourceLanguage, targetAudience = 'general', industry = 'technology', region, context, pseudoTranslation, pseudoOptions, namespace, skipWarnings = false } = args;
 
   if (!texts || !Array.isArray(texts) || texts.length === 0) {
     throw new Error('texts must be a non-empty array');
@@ -494,6 +504,7 @@ async function handleTranslateText(args) {
         pseudoTranslation: pseudoTranslation,
         pseudoOptions: pseudoOptions,
         namespace: namespace,
+        skipWarnings: skipWarnings,
       }
     }
   };
@@ -761,7 +772,8 @@ async function handleTranslateFile(args) {
     context,
     pseudoTranslation,
     pseudoOptions,
-    namespace
+    namespace,
+    skipWarnings = false
   } = args;
 
   if (!filePath && !fileContent) {
@@ -842,6 +854,7 @@ async function handleTranslateFile(args) {
   if (context !== undefined) requestArgs.context = context;
   if (pseudoTranslation !== undefined) requestArgs.pseudoTranslation = pseudoTranslation;
   if (pseudoOptions !== undefined) requestArgs.pseudoOptions = pseudoOptions;
+  if (skipWarnings !== undefined) requestArgs.skipWarnings = skipWarnings;
 
   // Use MCP JSON-RPC protocol for translate_file
   const mcpRequest = {
@@ -1747,11 +1760,11 @@ async function handleDownloadTranslations(args) {
       // Case 1: S3 Storage - download files from presigned URLs
       console.error(`📥 Downloading ${Object.keys(parsedResult.downloadUrls).length} translation files from S3...`);
 
-      for (const [language, urlInfo] of Object.entries(parsedResult.downloadUrls)) {
+      for (const [language, downloadUrl] of Object.entries(parsedResult.downloadUrls)) {
         try {
           console.error(`📥 Downloading ${language}...`);
 
-          const fileResponse = await axios.get(urlInfo.url, {
+          const fileResponse = await axios.get(downloadUrl, {
             responseType: 'text',
             timeout: 60000, // 1 minute per file
             headers: {

package/package.json

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