@l10nmonster/mcp 3.0.0-alpha.17 → 3.1.0

package/.releaserc.json

@@ -0,0 +1,31 @@
+{
+  "branches": [
+    "main",
+    {
+      "name": "next",
+      "prerelease": "alpha"
+    },
+    {
+      "name": "beta",
+      "prerelease": "beta"
+    }
+  ],
+  "tagFormat": "@l10nmonster/mcp@${version}",
+  "plugins": [
+    "@semantic-release/commit-analyzer",
+    "@semantic-release/release-notes-generator",
+    {
+      "path": "@semantic-release/changelog",
+      "changelogFile": "CHANGELOG.md"
+    },
+    {
+      "path": "@semantic-release/npm",
+      "npmPublish": false
+    },
+    {
+      "path": "@semantic-release/git",
+      "assets": ["CHANGELOG.md", "package.json"],
+      "message": "chore(release): @l10nmonster/mcp@${nextRelease.version} [skip ci]\n\n${nextRelease.notes}"
+    }
+  ]
+}

package/CHANGELOG.md

@@ -0,0 +1,13 @@
+# @l10nmonster/mcp [3.1.0](https://public-github/l10nmonster/l10nmonster/compare/@l10nmonster/mcp@3.0.0...@l10nmonster/mcp@3.1.0) (2025-12-20)
+
+
+### Bug Fixes
+
+* Make source query channel optional ([1addc68](https://public-github/l10nmonster/l10nmonster/commit/1addc68d009794a92588a28b816d7e9edbab6b47))
+* Pluralization improvements ([5964250](https://public-github/l10nmonster/l10nmonster/commit/596425092c425cc8d6c312ef58509c4c3c537431))
+* Version bumps ([d3030bd](https://public-github/l10nmonster/l10nmonster/commit/d3030bdd0af6ddbc79b3076af7427111ca9b04d0))
+
+
+### Features
+
+* implement an approach for mcp extensibility ([#50](https://public-github/l10nmonster/l10nmonster/issues/50)) ([5fcc89b](https://public-github/l10nmonster/l10nmonster/commit/5fcc89bef8c8af01d88f35dece8290989d04e4d5))

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@l10nmonster/mcp",
-  "version": "3.0.0-alpha.17",
+  "version": "3.1.0",
   "description": "L10n Monster Model Context Protocol (MCP) Server",
   "type": "module",
   "main": "index.js",
@@ -12,7 +12,7 @@
     "zod": "^3"
   },
   "peerDependencies": {
-    "@l10nmonster/core": "^3.0.0-alpha.0"
+    "@l10nmonster/core": "3.1.0"
   },
   "engines": {
     "node": ">=22.11.0"

package/tests/mcpToolValidation.test.js

@@ -352,16 +352,16 @@ describe('MCP Tool Input Validation and Output', () => {
                 assert.ok(result2.isError);
             });
 
-            it('should require channel parameter', async () => {
+            it('should query all channels when channel is omitted', async () => {
                 const handler = SourceQueryTool.handler(mockMM);
                 const result = await handler({
                     sourceLang: 'en',
                     targetLang: 'fr'
                 });
-                
-                assert.ok(result.isError);
-                const payload = JSON.parse(result.content[1].text);
-                assert.strictEqual(payload.code, 'INVALID_INPUT');
+
+                assert.ok(!result.isError);
+                const json = JSON.parse(result.content[0].text);
+                assert.ok(json.translationUnits);
             });
 
             it('should accept optional whereCondition', async () => {
@@ -385,16 +385,18 @@ describe('MCP Tool Input Validation and Output', () => {
                 assert.ok(!result2.isError);
             });
 
-            it('should reject empty channel', async () => {
+            it('should treat empty channel as query all channels', async () => {
                 const handler = SourceQueryTool.handler(mockMM);
                 const result = await handler({
                     sourceLang: 'en',
                     targetLang: 'fr',
                     channel: ''
                 });
-                
-                // Empty string should fail Zod validation (string().min(1) implicit)
-                assert.ok(result.isError);
+
+                // Empty string channel is falsy, so queries all channels
+                assert.ok(!result.isError);
+                const json = JSON.parse(result.content[0].text);
+                assert.ok(json.translationUnits);
             });
         });
 

package/tools/sourceQuery.js

@@ -32,7 +32,8 @@ You can write your own where conditions using SQL syntaxt against the following
             targetLang: z.string()
                 .describe('Target language code (e.g., "es-419")'),
             channel: z.string()
-                .describe('Channel ID to query sources from'),
+                .optional()
+                .describe('Channel ID to query sources from. If omitted, queries all channels.'),
             whereCondition: z.string()
                 .optional()
                 .describe('SQL WHERE condition against sources (default: "true" to match all)'),
@@ -40,12 +41,14 @@ You can write your own where conditions using SQL syntaxt against the following
     };
 
     static async execute(mm, args) {
-        const { sourceLang, targetLang, channel: channelId } = args;
+        const { sourceLang, targetLang, channel } = args;
         const whereCondition = args.whereCondition ?? 'true';
 
         const availableChannels = mm.rm.channelIds ?? [];
-        if (availableChannels.length > 0 && !availableChannels.includes(channelId)) {
-            throw new McpNotFoundError(`Channel "${channelId}" not found`, {
+        const channels = channel ? [channel] : availableChannels;
+
+        if (channel && availableChannels.length > 0 && !availableChannels.includes(channel)) {
+            throw new McpNotFoundError(`Channel "${channel}" not found`, {
                 hints: [`Available channels: ${availableChannels.join(', ')}`]
             });
         }
@@ -61,19 +64,22 @@ You can write your own where conditions using SQL syntaxt against the following
             });
         }
 
-        let tus;
-        try {
-            tus = await tm.querySource(channelId, whereCondition);
-        } catch (error) {
-            throw new McpToolError('Failed to execute query against source snapshot', {
-                code: 'QUERY_FAILED',
-                hints: [
-                    'Verify that your SQL WHERE clause only references supported columns.',
-                    'Escaping: wrap string literals in single quotes.'
-                ],
-                details: { channelId, whereCondition },
-                cause: error
-            });
+        const tus = [];
+        for (const channelId of channels) {
+            try {
+                const channelTus = await tm.querySource(channelId, whereCondition);
+                tus.push(...channelTus);
+            } catch (error) {
+                throw new McpToolError('Failed to execute query against source snapshot', {
+                    code: 'QUERY_FAILED',
+                    hints: [
+                        'Verify that your SQL WHERE clause only references supported columns.',
+                        'Escaping: wrap string literals in single quotes.'
+                    ],
+                    details: { channelId, whereCondition },
+                    cause: error
+                });
+            }
         }
 
         return {