@i18n-agent/mcp-client 1.8.20 → 1.8.21

package/README.md

@@ -346,7 +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
+- `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
 

package/mcp-client.js

@@ -18,6 +18,7 @@ import {
 import axios from 'axios';
 import fs from 'fs';
 import path from 'path';
+import { detectNamespaceFromPath, generateNamespaceSuggestions, getNamespaceSuggestionText } from './namespace-detector.js';
 
 const server = new Server(
   {
@@ -115,10 +116,10 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
             },
             namespace: {
               type: 'string',
-              description: 'Unique namespace identifier for backend tracking and project organization (required for production use)',
+              description: 'Optional namespace identifier for backend tracking and project organization (recommended for file-based workflows)',
             },
           },
-          required: ['texts', 'targetLanguages', 'namespace'],
+          required: ['texts', 'targetLanguages'],
         },
       },
       {
@@ -450,9 +451,7 @@ async function handleTranslateText(args) {
     throw new Error('texts must be a non-empty array');
   }
 
-  if (!namespace) {
-    throw new Error('namespace is required for translation tracking and project organization');
-  }
+  // Namespace is optional for text translation, but recommended for organizational tracking
 
   // Normalize targetLanguages - accept both string and array
   let targetLanguages = rawTargetLanguages;
@@ -769,8 +768,26 @@ async function handleTranslateFile(args) {
     throw new Error('Either filePath or fileContent must be provided');
   }
 
-  if (!namespace) {
-    throw new Error('namespace is required for translation tracking and project organization');
+  // Auto-detect namespace if not provided and filePath is available
+  let finalNamespace = namespace;
+  let detectionInfo = null;
+
+  if (!namespace && filePath) {
+    const detection = detectNamespaceFromPath(filePath);
+    if (detection.suggestion && detection.confidence > 0.5) {
+      finalNamespace = detection.suggestion;
+      detectionInfo = detection;
+      console.error(`🎯 [MCP CLIENT] Auto-detected namespace: "${finalNamespace}" (confidence: ${Math.round(detection.confidence * 100)}%, source: ${detection.source})`);
+    }
+  }
+
+  if (!finalNamespace) {
+    // Provide helpful suggestions when namespace is missing
+    const suggestionText = filePath
+      ? getNamespaceSuggestionText(filePath, path.basename(filePath))
+      : getNamespaceSuggestionText(null, null);
+
+    throw new Error(`namespace is required for translation tracking and project organization.\n\n${suggestionText}`);
   }
 
   // Normalize targetLanguages - accept both string and array
@@ -815,7 +832,7 @@ async function handleTranslateFile(args) {
     industry,
     preserveKeys,
     outputFormat,
-    namespace
+    namespace: finalNamespace
   };
 
   // Add optional parameters only if defined

package/package.json

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