string-catalog-mcp 1.0.0

package/dist/tools/list-supported-languages.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerListSupportedLanguages = registerListSupportedLanguages;
+const zod_1 = require("zod");
+const string_catalog_1 = require("../string-catalog");
+function registerListSupportedLanguages(server) {
+    server.registerTool('list_supported_languages', {
+        description: 'List all supported languages in a given Xcode String Catalog (.xcstrings) file. Returns the source language and all languages that have translations.',
+        inputSchema: {
+            filePath: zod_1.z.string().describe('Absolute path to the .xcstrings file'),
+        },
+    }, async ({ filePath }) => {
+        const catalog = new string_catalog_1.StringCatalog(filePath);
+        const languages = catalog.getSupportedLanguages();
+        const sourceLanguage = catalog.getSourceLanguage();
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        sourceLanguage,
+                        supportedLanguages: languages,
+                        count: languages.length,
+                    }, null, 2),
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibGlzdC1zdXBwb3J0ZWQtbGFuZ3VhZ2VzLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL3Rvb2xzL2xpc3Qtc3VwcG9ydGVkLWxhbmd1YWdlcy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOztBQUlBLHdFQWlDQztBQXBDRCw2QkFBd0I7QUFDeEIsc0RBQWtEO0FBRWxELFNBQWdCLDhCQUE4QixDQUFDLE1BQWlCO0lBQzVELE1BQU0sQ0FBQyxZQUFZLENBQ2YsMEJBQTBCLEVBQzFCO1FBQ0ksV0FBVyxFQUNQLHVKQUF1SjtRQUMzSixXQUFXLEVBQUU7WUFDVCxRQUFRLEVBQUUsT0FBQyxDQUFDLE1BQU0sRUFBRSxDQUFDLFFBQVEsQ0FBQyxzQ0FBc0MsQ0FBQztTQUN4RTtLQUNKLEVBQ0QsS0FBSyxFQUFFLEVBQUUsUUFBUSxFQUFFLEVBQUUsRUFBRTtRQUNuQixNQUFNLE9BQU8sR0FBRyxJQUFJLDhCQUFhLENBQUMsUUFBUSxDQUFDLENBQUM7UUFDNUMsTUFBTSxTQUFTLEdBQUcsT0FBTyxDQUFDLHFCQUFxQixFQUFFLENBQUM7UUFDbEQsTUFBTSxjQUFjLEdBQUcsT0FBTyxDQUFDLGlCQUFpQixFQUFFLENBQUM7UUFFbkQsT0FBTztZQUNILE9BQU8sRUFBRTtnQkFDTDtvQkFDSSxJQUFJLEVBQUUsTUFBZTtvQkFDckIsSUFBSSxFQUFFLElBQUksQ0FBQyxTQUFTLENBQ2hCO3dCQUNJLGNBQWM7d0JBQ2Qsa0JBQWtCLEVBQUUsU0FBUzt3QkFDN0IsS0FBSyxFQUFFLFNBQVMsQ0FBQyxNQUFNO3FCQUMxQixFQUNELElBQUksRUFDSixDQUFDLENBQ0o7aUJBQ0o7YUFDSjtTQUNKLENBQUM7SUFDTixDQUFDLENBQ0osQ0FBQztBQUNOLENBQUMiLCJzb3VyY2VzQ29udGVudCI6WyJpbXBvcnQgeyBNY3BTZXJ2ZXIgfSBmcm9tICdAbW9kZWxjb250ZXh0cHJvdG9jb2wvc2RrL3NlcnZlci9tY3AuanMnO1xuaW1wb3J0IHsgeiB9IGZyb20gJ3pvZCc7XG5pbXBvcnQgeyBTdHJpbmdDYXRhbG9nIH0gZnJvbSAnLi4vc3RyaW5nLWNhdGFsb2cnO1xuXG5leHBvcnQgZnVuY3Rpb24gcmVnaXN0ZXJMaXN0U3VwcG9ydGVkTGFuZ3VhZ2VzKHNlcnZlcjogTWNwU2VydmVyKSB7XG4gICAgc2VydmVyLnJlZ2lzdGVyVG9vbChcbiAgICAgICAgJ2xpc3Rfc3VwcG9ydGVkX2xhbmd1YWdlcycsXG4gICAgICAgIHtcbiAgICAgICAgICAgIGRlc2NyaXB0aW9uOlxuICAgICAgICAgICAgICAgICdMaXN0IGFsbCBzdXBwb3J0ZWQgbGFuZ3VhZ2VzIGluIGEgZ2l2ZW4gWGNvZGUgU3RyaW5nIENhdGFsb2cgKC54Y3N0cmluZ3MpIGZpbGUuIFJldHVybnMgdGhlIHNvdXJjZSBsYW5ndWFnZSBhbmQgYWxsIGxhbmd1YWdlcyB0aGF0IGhhdmUgdHJhbnNsYXRpb25zLicsXG4gICAgICAgICAgICBpbnB1dFNjaGVtYToge1xuICAgICAgICAgICAgICAgIGZpbGVQYXRoOiB6LnN0cmluZygpLmRlc2NyaWJlKCdBYnNvbHV0ZSBwYXRoIHRvIHRoZSAueGNzdHJpbmdzIGZpbGUnKSxcbiAgICAgICAgICAgIH0sXG4gICAgICAgIH0sXG4gICAgICAgIGFzeW5jICh7IGZpbGVQYXRoIH0pID0+IHtcbiAgICAgICAgICAgIGNvbnN0IGNhdGFsb2cgPSBuZXcgU3RyaW5nQ2F0YWxvZyhmaWxlUGF0aCk7XG4gICAgICAgICAgICBjb25zdCBsYW5ndWFnZXMgPSBjYXRhbG9nLmdldFN1cHBvcnRlZExhbmd1YWdlcygpO1xuICAgICAgICAgICAgY29uc3Qgc291cmNlTGFuZ3VhZ2UgPSBjYXRhbG9nLmdldFNvdXJjZUxhbmd1YWdlKCk7XG5cbiAgICAgICAgICAgIHJldHVybiB7XG4gICAgICAgICAgICAgICAgY29udGVudDogW1xuICAgICAgICAgICAgICAgICAgICB7XG4gICAgICAgICAgICAgICAgICAgICAgICB0eXBlOiAndGV4dCcgYXMgY29uc3QsXG4gICAgICAgICAgICAgICAgICAgICAgICB0ZXh0OiBKU09OLnN0cmluZ2lmeShcbiAgICAgICAgICAgICAgICAgICAgICAgICAgICB7XG4gICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgIHNvdXJjZUxhbmd1YWdlLFxuICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICBzdXBwb3J0ZWRMYW5ndWFnZXM6IGxhbmd1YWdlcyxcbiAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgY291bnQ6IGxhbmd1YWdlcy5sZW5ndGgsXG4gICAgICAgICAgICAgICAgICAgICAgICAgICAgfSxcbiAgICAgICAgICAgICAgICAgICAgICAgICAgICBudWxsLFxuICAgICAgICAgICAgICAgICAgICAgICAgICAgIDJcbiAgICAgICAgICAgICAgICAgICAgICAgICksXG4gICAgICAgICAgICAgICAgICAgIH0sXG4gICAgICAgICAgICAgICAgXSxcbiAgICAgICAgICAgIH07XG4gICAgICAgIH1cbiAgICApO1xufVxuIl19

package/dist/tools/search-keys.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerSearchKeys(server: McpServer): void;

package/dist/tools/search-keys.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerSearchKeys = registerSearchKeys;
+const zod_1 = require("zod");
+const string_catalog_1 = require("../string-catalog");
+function registerSearchKeys(server) {
+    server.registerTool('search_keys', {
+        description: 'Search for localization keys containing a specific substring. Useful for finding keys when you only know part of the key name.',
+        inputSchema: {
+            filePath: zod_1.z.string().describe('Absolute path to the .xcstrings file'),
+            query: zod_1.z
+                .string()
+                .describe('Substring to search for in key names (case-insensitive)'),
+        },
+    }, async ({ filePath, query }) => {
+        const catalog = new string_catalog_1.StringCatalog(filePath);
+        const keys = catalog.searchKeys(query);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        query,
+                        matchingKeys: keys,
+                        count: keys.length,
+                    }, null, 2),
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic2VhcmNoLWtleXMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvdG9vbHMvc2VhcmNoLWtleXMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7QUFJQSxnREFtQ0M7QUF0Q0QsNkJBQXdCO0FBQ3hCLHNEQUFrRDtBQUVsRCxTQUFnQixrQkFBa0IsQ0FBQyxNQUFpQjtJQUNoRCxNQUFNLENBQUMsWUFBWSxDQUNmLGFBQWEsRUFDYjtRQUNJLFdBQVcsRUFDUCxnSUFBZ0k7UUFDcEksV0FBVyxFQUFFO1lBQ1QsUUFBUSxFQUFFLE9BQUMsQ0FBQyxNQUFNLEVBQUUsQ0FBQyxRQUFRLENBQUMsc0NBQXNDLENBQUM7WUFDckUsS0FBSyxFQUFFLE9BQUM7aUJBQ0gsTUFBTSxFQUFFO2lCQUNSLFFBQVEsQ0FBQyx5REFBeUQsQ0FBQztTQUMzRTtLQUNKLEVBQ0QsS0FBSyxFQUFFLEVBQUUsUUFBUSxFQUFFLEtBQUssRUFBRSxFQUFFLEVBQUU7UUFDMUIsTUFBTSxPQUFPLEdBQUcsSUFBSSw4QkFBYSxDQUFDLFFBQVEsQ0FBQyxDQUFDO1FBQzVDLE1BQU0sSUFBSSxHQUFHLE9BQU8sQ0FBQyxVQUFVLENBQUMsS0FBSyxDQUFDLENBQUM7UUFFdkMsT0FBTztZQUNILE9BQU8sRUFBRTtnQkFDTDtvQkFDSSxJQUFJLEVBQUUsTUFBZTtvQkFDckIsSUFBSSxFQUFFLElBQUksQ0FBQyxTQUFTLENBQ2hCO3dCQUNJLEtBQUs7d0JBQ0wsWUFBWSxFQUFFLElBQUk7d0JBQ2xCLEtBQUssRUFBRSxJQUFJLENBQUMsTUFBTTtxQkFDckIsRUFDRCxJQUFJLEVBQ0osQ0FBQyxDQUNKO2lCQUNKO2FBQ0o7U0FDSixDQUFDO0lBQ04sQ0FBQyxDQUNKLENBQUM7QUFDTixDQUFDIiwic291cmNlc0NvbnRlbnQiOlsiaW1wb3J0IHsgTWNwU2VydmVyIH0gZnJvbSAnQG1vZGVsY29udGV4dHByb3RvY29sL3Nkay9zZXJ2ZXIvbWNwLmpzJztcbmltcG9ydCB7IHogfSBmcm9tICd6b2QnO1xuaW1wb3J0IHsgU3RyaW5nQ2F0YWxvZyB9IGZyb20gJy4uL3N0cmluZy1jYXRhbG9nJztcblxuZXhwb3J0IGZ1bmN0aW9uIHJlZ2lzdGVyU2VhcmNoS2V5cyhzZXJ2ZXI6IE1jcFNlcnZlcikge1xuICAgIHNlcnZlci5yZWdpc3RlclRvb2woXG4gICAgICAgICdzZWFyY2hfa2V5cycsXG4gICAgICAgIHtcbiAgICAgICAgICAgIGRlc2NyaXB0aW9uOlxuICAgICAgICAgICAgICAgICdTZWFyY2ggZm9yIGxvY2FsaXphdGlvbiBrZXlzIGNvbnRhaW5pbmcgYSBzcGVjaWZpYyBzdWJzdHJpbmcuIFVzZWZ1bCBmb3IgZmluZGluZyBrZXlzIHdoZW4geW91IG9ubHkga25vdyBwYXJ0IG9mIHRoZSBrZXkgbmFtZS4nLFxuICAgICAgICAgICAgaW5wdXRTY2hlbWE6IHtcbiAgICAgICAgICAgICAgICBmaWxlUGF0aDogei5zdHJpbmcoKS5kZXNjcmliZSgnQWJzb2x1dGUgcGF0aCB0byB0aGUgLnhjc3RyaW5ncyBmaWxlJyksXG4gICAgICAgICAgICAgICAgcXVlcnk6IHpcbiAgICAgICAgICAgICAgICAgICAgLnN0cmluZygpXG4gICAgICAgICAgICAgICAgICAgIC5kZXNjcmliZSgnU3Vic3RyaW5nIHRvIHNlYXJjaCBmb3IgaW4ga2V5IG5hbWVzIChjYXNlLWluc2Vuc2l0aXZlKScpLFxuICAgICAgICAgICAgfSxcbiAgICAgICAgfSxcbiAgICAgICAgYXN5bmMgKHsgZmlsZVBhdGgsIHF1ZXJ5IH0pID0+IHtcbiAgICAgICAgICAgIGNvbnN0IGNhdGFsb2cgPSBuZXcgU3RyaW5nQ2F0YWxvZyhmaWxlUGF0aCk7XG4gICAgICAgICAgICBjb25zdCBrZXlzID0gY2F0YWxvZy5zZWFyY2hLZXlzKHF1ZXJ5KTtcblxuICAgICAgICAgICAgcmV0dXJuIHtcbiAgICAgICAgICAgICAgICBjb250ZW50OiBbXG4gICAgICAgICAgICAgICAgICAgIHtcbiAgICAgICAgICAgICAgICAgICAgICAgIHR5cGU6ICd0ZXh0JyBhcyBjb25zdCxcbiAgICAgICAgICAgICAgICAgICAgICAgIHRleHQ6IEpTT04uc3RyaW5naWZ5KFxuICAgICAgICAgICAgICAgICAgICAgICAgICAgIHtcbiAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgcXVlcnksXG4gICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgIG1hdGNoaW5nS2V5czoga2V5cyxcbiAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgY291bnQ6IGtleXMubGVuZ3RoLFxuICAgICAgICAgICAgICAgICAgICAgICAgICAgIH0sXG4gICAgICAgICAgICAgICAgICAgICAgICAgICAgbnVsbCxcbiAgICAgICAgICAgICAgICAgICAgICAgICAgICAyXG4gICAgICAgICAgICAgICAgICAgICAgICApLFxuICAgICAgICAgICAgICAgICAgICB9LFxuICAgICAgICAgICAgICAgIF0sXG4gICAgICAgICAgICB9O1xuICAgICAgICB9XG4gICAgKTtcbn1cbiJdfQ==

package/dist/tools/update-translations.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerUpdateTranslations(server: McpServer): void;

package/dist/tools/update-translations.js

@@ -0,0 +1,78 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerUpdateTranslations = registerUpdateTranslations;
+const zod_1 = require("zod");
+const string_catalog_1 = require("../string-catalog");
+const toolDescription = `Update or add translations to a String Catalog. Accepts an array of translation entries.
+
+IMPORTANT: iOS strings support format placeholders that must be preserved in translations:
+- %@ for strings (objects)
+- %d or %lld for integers
+- %f for floating point numbers
+- %1$@, %2$@ etc. for positional arguments (order can be changed in translations)
+
+Example input:
+{
+  "data": [
+    {
+      "key": "hello_world",
+      "translations": [
+        { "language": "en", "value": "Hello World" },
+        { "language": "de", "value": "Hallo Welt" },
+        { "language": "no", "value": "Hei Verden" }
+      ],
+      "comment": "Greeting message shown on home screen"
+    },
+    {
+      "key": "items_count",
+      "translations": [
+        { "language": "en", "value": "%lld items" },
+        { "language": "de", "value": "%lld Elemente" }
+      ]
+    }
+  ]
+}`;
+const translationEntrySchema = zod_1.z.object({
+    language: zod_1.z.string().describe('Language code (e.g., "en", "de", "no", "vi")'),
+    value: zod_1.z
+        .string()
+        .describe('The translated text. Preserve any format placeholders like %@, %lld, %d'),
+    state: zod_1.z
+        .enum(['new', 'translated', 'needs_review', 'stale'])
+        .optional()
+        .describe('Translation state (defaults to "translated")'),
+});
+const dataEntrySchema = zod_1.z.object({
+    key: zod_1.z.string().describe('The localization key'),
+    translations: zod_1.z.array(translationEntrySchema).describe('Array of language translations'),
+    comment: zod_1.z.string().optional().describe('Optional comment describing the string context'),
+});
+const inputSchema = zod_1.z.object({
+    filePath: zod_1.z.string().describe('Absolute path to the .xcstrings file'),
+    data: zod_1.z.array(dataEntrySchema).describe('Array of translation entries to add or update'),
+});
+function registerUpdateTranslations(server) {
+    server.registerTool('update_translations', {
+        description: toolDescription,
+        inputSchema,
+    }, async ({ filePath, data }) => {
+        const catalog = new string_catalog_1.StringCatalog(filePath);
+        const result = catalog.updateTranslations(data);
+        catalog.save();
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        success: true,
+                        updatedKeys: result.updated,
+                        createdKeys: result.created,
+                        totalUpdated: result.updated.length,
+                        totalCreated: result.created.length,
+                    }, null, 2),
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidXBkYXRlLXRyYW5zbGF0aW9ucy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy90b29scy91cGRhdGUtdHJhbnNsYXRpb25zLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7O0FBd0RBLGdFQWdDQztBQXZGRCw2QkFBd0I7QUFDeEIsc0RBQWtEO0FBRWxELE1BQU0sZUFBZSxHQUFHOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0VBNEJ0QixDQUFDO0FBRUgsTUFBTSxzQkFBc0IsR0FBRyxPQUFDLENBQUMsTUFBTSxDQUFDO0lBQ3BDLFFBQVEsRUFBRSxPQUFDLENBQUMsTUFBTSxFQUFFLENBQUMsUUFBUSxDQUFDLDhDQUE4QyxDQUFDO0lBQzdFLEtBQUssRUFBRSxPQUFDO1NBQ0gsTUFBTSxFQUFFO1NBQ1IsUUFBUSxDQUFDLHlFQUF5RSxDQUFDO0lBQ3hGLEtBQUssRUFBRSxPQUFDO1NBQ0gsSUFBSSxDQUFDLENBQUMsS0FBSyxFQUFFLFlBQVksRUFBRSxjQUFjLEVBQUUsT0FBTyxDQUFDLENBQUM7U0FDcEQsUUFBUSxFQUFFO1NBQ1YsUUFBUSxDQUFDLDhDQUE4QyxDQUFDO0NBQ2hFLENBQUMsQ0FBQztBQUVILE1BQU0sZUFBZSxHQUFHLE9BQUMsQ0FBQyxNQUFNLENBQUM7SUFDN0IsR0FBRyxFQUFFLE9BQUMsQ0FBQyxNQUFNLEVBQUUsQ0FBQyxRQUFRLENBQUMsc0JBQXNCLENBQUM7SUFDaEQsWUFBWSxFQUFFLE9BQUMsQ0FBQyxLQUFLLENBQUMsc0JBQXNCLENBQUMsQ0FBQyxRQUFRLENBQUMsZ0NBQWdDLENBQUM7SUFDeEYsT0FBTyxFQUFFLE9BQUMsQ0FBQyxNQUFNLEVBQUUsQ0FBQyxRQUFRLEVBQUUsQ0FBQyxRQUFRLENBQUMsZ0RBQWdELENBQUM7Q0FDNUYsQ0FBQyxDQUFDO0FBRUgsTUFBTSxXQUFXLEdBQUcsT0FBQyxDQUFDLE1BQU0sQ0FBQztJQUN6QixRQUFRLEVBQUUsT0FBQyxDQUFDLE1BQU0sRUFBRSxDQUFDLFFBQVEsQ0FBQyxzQ0FBc0MsQ0FBQztJQUNyRSxJQUFJLEVBQUUsT0FBQyxDQUFDLEtBQUssQ0FBQyxlQUFlLENBQUMsQ0FBQyxRQUFRLENBQUMsK0NBQStDLENBQUM7Q0FDM0YsQ0FBQyxDQUFDO0FBRUgsU0FBZ0IsMEJBQTBCLENBQUMsTUFBaUI7SUFDeEQsTUFBTSxDQUFDLFlBQVksQ0FDZixxQkFBcUIsRUFDckI7UUFDSSxXQUFXLEVBQUUsZUFBZTtRQUM1QixXQUFXO0tBQ2QsRUFDRCxLQUFLLEVBQUUsRUFBRSxRQUFRLEVBQUUsSUFBSSxFQUFFLEVBQUUsRUFBRTtRQUN6QixNQUFNLE9BQU8sR0FBRyxJQUFJLDhCQUFhLENBQUMsUUFBUSxDQUFDLENBQUM7UUFDNUMsTUFBTSxNQUFNLEdBQUcsT0FBTyxDQUFDLGtCQUFrQixDQUFDLElBQUksQ0FBQyxDQUFDO1FBQ2hELE9BQU8sQ0FBQyxJQUFJLEVBQUUsQ0FBQztRQUVmLE9BQU87WUFDSCxPQUFPLEVBQUU7Z0JBQ0w7b0JBQ0ksSUFBSSxFQUFFLE1BQWU7b0JBQ3JCLElBQUksRUFBRSxJQUFJLENBQUMsU0FBUyxDQUNoQjt3QkFDSSxPQUFPLEVBQUUsSUFBSTt3QkFDYixXQUFXLEVBQUUsTUFBTSxDQUFDLE9BQU87d0JBQzNCLFdBQVcsRUFBRSxNQUFNLENBQUMsT0FBTzt3QkFDM0IsWUFBWSxFQUFFLE1BQU0sQ0FBQyxPQUFPLENBQUMsTUFBTTt3QkFDbkMsWUFBWSxFQUFFLE1BQU0sQ0FBQyxPQUFPLENBQUMsTUFBTTtxQkFDdEMsRUFDRCxJQUFJLEVBQ0osQ0FBQyxDQUNKO2lCQUNKO2FBQ0o7U0FDSixDQUFDO0lBQ04sQ0FBQyxDQUNKLENBQUM7QUFDTixDQUFDIiwic291cmNlc0NvbnRlbnQiOlsiaW1wb3J0IHsgTWNwU2VydmVyIH0gZnJvbSAnQG1vZGVsY29udGV4dHByb3RvY29sL3Nkay9zZXJ2ZXIvbWNwLmpzJztcbmltcG9ydCB7IHogfSBmcm9tICd6b2QnO1xuaW1wb3J0IHsgU3RyaW5nQ2F0YWxvZyB9IGZyb20gJy4uL3N0cmluZy1jYXRhbG9nJztcblxuY29uc3QgdG9vbERlc2NyaXB0aW9uID0gYFVwZGF0ZSBvciBhZGQgdHJhbnNsYXRpb25zIHRvIGEgU3RyaW5nIENhdGFsb2cuIEFjY2VwdHMgYW4gYXJyYXkgb2YgdHJhbnNsYXRpb24gZW50cmllcy5cblxuSU1QT1JUQU5UOiBpT1Mgc3RyaW5ncyBzdXBwb3J0IGZvcm1hdCBwbGFjZWhvbGRlcnMgdGhhdCBtdXN0IGJlIHByZXNlcnZlZCBpbiB0cmFuc2xhdGlvbnM6XG4tICVAIGZvciBzdHJpbmdzIChvYmplY3RzKVxuLSAlZCBvciAlbGxkIGZvciBpbnRlZ2Vyc1xuLSAlZiBmb3IgZmxvYXRpbmcgcG9pbnQgbnVtYmVyc1xuLSAlMSRALCAlMiRAIGV0Yy4gZm9yIHBvc2l0aW9uYWwgYXJndW1lbnRzIChvcmRlciBjYW4gYmUgY2hhbmdlZCBpbiB0cmFuc2xhdGlvbnMpXG5cbkV4YW1wbGUgaW5wdXQ6XG57XG4gIFwiZGF0YVwiOiBbXG4gICAge1xuICAgICAgXCJrZXlcIjogXCJoZWxsb193b3JsZFwiLFxuICAgICAgXCJ0cmFuc2xhdGlvbnNcIjogW1xuICAgICAgICB7IFwibGFuZ3VhZ2VcIjogXCJlblwiLCBcInZhbHVlXCI6IFwiSGVsbG8gV29ybGRcIiB9LFxuICAgICAgICB7IFwibGFuZ3VhZ2VcIjogXCJkZVwiLCBcInZhbHVlXCI6IFwiSGFsbG8gV2VsdFwiIH0sXG4gICAgICAgIHsgXCJsYW5ndWFnZVwiOiBcIm5vXCIsIFwidmFsdWVcIjogXCJIZWkgVmVyZGVuXCIgfVxuICAgICAgXSxcbiAgICAgIFwiY29tbWVudFwiOiBcIkdyZWV0aW5nIG1lc3NhZ2Ugc2hvd24gb24gaG9tZSBzY3JlZW5cIlxuICAgIH0sXG4gICAge1xuICAgICAgXCJrZXlcIjogXCJpdGVtc19jb3VudFwiLFxuICAgICAgXCJ0cmFuc2xhdGlvbnNcIjogW1xuICAgICAgICB7IFwibGFuZ3VhZ2VcIjogXCJlblwiLCBcInZhbHVlXCI6IFwiJWxsZCBpdGVtc1wiIH0sXG4gICAgICAgIHsgXCJsYW5ndWFnZVwiOiBcImRlXCIsIFwidmFsdWVcIjogXCIlbGxkIEVsZW1lbnRlXCIgfVxuICAgICAgXVxuICAgIH1cbiAgXVxufWA7XG5cbmNvbnN0IHRyYW5zbGF0aW9uRW50cnlTY2hlbWEgPSB6Lm9iamVjdCh7XG4gICAgbGFuZ3VhZ2U6IHouc3RyaW5nKCkuZGVzY3JpYmUoJ0xhbmd1YWdlIGNvZGUgKGUuZy4sIFwiZW5cIiwgXCJkZVwiLCBcIm5vXCIsIFwidmlcIiknKSxcbiAgICB2YWx1ZTogelxuICAgICAgICAuc3RyaW5nKClcbiAgICAgICAgLmRlc2NyaWJlKCdUaGUgdHJhbnNsYXRlZCB0ZXh0LiBQcmVzZXJ2ZSBhbnkgZm9ybWF0IHBsYWNlaG9sZGVycyBsaWtlICVALCAlbGxkLCAlZCcpLFxuICAgIHN0YXRlOiB6XG4gICAgICAgIC5lbnVtKFsnbmV3JywgJ3RyYW5zbGF0ZWQnLCAnbmVlZHNfcmV2aWV3JywgJ3N0YWxlJ10pXG4gICAgICAgIC5vcHRpb25hbCgpXG4gICAgICAgIC5kZXNjcmliZSgnVHJhbnNsYXRpb24gc3RhdGUgKGRlZmF1bHRzIHRvIFwidHJhbnNsYXRlZFwiKScpLFxufSk7XG5cbmNvbnN0IGRhdGFFbnRyeVNjaGVtYSA9IHoub2JqZWN0KHtcbiAgICBrZXk6IHouc3RyaW5nKCkuZGVzY3JpYmUoJ1RoZSBsb2NhbGl6YXRpb24ga2V5JyksXG4gICAgdHJhbnNsYXRpb25zOiB6LmFycmF5KHRyYW5zbGF0aW9uRW50cnlTY2hlbWEpLmRlc2NyaWJlKCdBcnJheSBvZiBsYW5ndWFnZSB0cmFuc2xhdGlvbnMnKSxcbiAgICBjb21tZW50OiB6LnN0cmluZygpLm9wdGlvbmFsKCkuZGVzY3JpYmUoJ09wdGlvbmFsIGNvbW1lbnQgZGVzY3JpYmluZyB0aGUgc3RyaW5nIGNvbnRleHQnKSxcbn0pO1xuXG5jb25zdCBpbnB1dFNjaGVtYSA9IHoub2JqZWN0KHtcbiAgICBmaWxlUGF0aDogei5zdHJpbmcoKS5kZXNjcmliZSgnQWJzb2x1dGUgcGF0aCB0byB0aGUgLnhjc3RyaW5ncyBmaWxlJyksXG4gICAgZGF0YTogei5hcnJheShkYXRhRW50cnlTY2hlbWEpLmRlc2NyaWJlKCdBcnJheSBvZiB0cmFuc2xhdGlvbiBlbnRyaWVzIHRvIGFkZCBvciB1cGRhdGUnKSxcbn0pO1xuXG5leHBvcnQgZnVuY3Rpb24gcmVnaXN0ZXJVcGRhdGVUcmFuc2xhdGlvbnMoc2VydmVyOiBNY3BTZXJ2ZXIpIHtcbiAgICBzZXJ2ZXIucmVnaXN0ZXJUb29sKFxuICAgICAgICAndXBkYXRlX3RyYW5zbGF0aW9ucycsXG4gICAgICAgIHtcbiAgICAgICAgICAgIGRlc2NyaXB0aW9uOiB0b29sRGVzY3JpcHRpb24sXG4gICAgICAgICAgICBpbnB1dFNjaGVtYSxcbiAgICAgICAgfSxcbiAgICAgICAgYXN5bmMgKHsgZmlsZVBhdGgsIGRhdGEgfSkgPT4ge1xuICAgICAgICAgICAgY29uc3QgY2F0YWxvZyA9IG5ldyBTdHJpbmdDYXRhbG9nKGZpbGVQYXRoKTtcbiAgICAgICAgICAgIGNvbnN0IHJlc3VsdCA9IGNhdGFsb2cudXBkYXRlVHJhbnNsYXRpb25zKGRhdGEpO1xuICAgICAgICAgICAgY2F0YWxvZy5zYXZlKCk7XG5cbiAgICAgICAgICAgIHJldHVybiB7XG4gICAgICAgICAgICAgICAgY29udGVudDogW1xuICAgICAgICAgICAgICAgICAgICB7XG4gICAgICAgICAgICAgICAgICAgICAgICB0eXBlOiAndGV4dCcgYXMgY29uc3QsXG4gICAgICAgICAgICAgICAgICAgICAgICB0ZXh0OiBKU09OLnN0cmluZ2lmeShcbiAgICAgICAgICAgICAgICAgICAgICAgICAgICB7XG4gICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgIHN1Y2Nlc3M6IHRydWUsXG4gICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgIHVwZGF0ZWRLZXlzOiByZXN1bHQudXBkYXRlZCxcbiAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgY3JlYXRlZEtleXM6IHJlc3VsdC5jcmVhdGVkLFxuICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICB0b3RhbFVwZGF0ZWQ6IHJlc3VsdC51cGRhdGVkLmxlbmd0aCxcbiAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgdG90YWxDcmVhdGVkOiByZXN1bHQuY3JlYXRlZC5sZW5ndGgsXG4gICAgICAgICAgICAgICAgICAgICAgICAgICAgfSxcbiAgICAgICAgICAgICAgICAgICAgICAgICAgICBudWxsLFxuICAgICAgICAgICAgICAgICAgICAgICAgICAgIDJcbiAgICAgICAgICAgICAgICAgICAgICAgICksXG4gICAgICAgICAgICAgICAgICAgIH0sXG4gICAgICAgICAgICAgICAgXSxcbiAgICAgICAgICAgIH07XG4gICAgICAgIH1cbiAgICApO1xufVxuIl19

package/dist/types.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Types for Xcode String Catalog (.xcstrings) file format
+ */
+/** State of a localization string */
+export type LocalizationState = 'new' | 'translated' | 'needs_review' | 'stale';
+/** A single string unit containing the translation value and state */
+export interface StringUnit {
+    state: LocalizationState;
+    value: string;
+}
+/** Localization entry for a single language */
+export interface LocalizationEntry {
+    stringUnit?: StringUnit;
+    /** For plural variations */
+    variations?: {
+        plural?: {
+            zero?: {
+                stringUnit: StringUnit;
+            };
+            one?: {
+                stringUnit: StringUnit;
+            };
+            two?: {
+                stringUnit: StringUnit;
+            };
+            few?: {
+                stringUnit: StringUnit;
+            };
+            many?: {
+                stringUnit: StringUnit;
+            };
+            other?: {
+                stringUnit: StringUnit;
+            };
+        };
+        device?: Record<string, {
+            stringUnit: StringUnit;
+        }>;
+    };
+}
+/** All localizations for a single string key */
+export interface StringLocalizations {
+    [languageCode: string]: LocalizationEntry;
+}
+/** A single string entry in the catalog */
+export interface StringEntry {
+    comment?: string;
+    extractionState?: 'manual' | 'extracted_with_value' | 'stale';
+    localizations?: StringLocalizations;
+}
+/** Root structure of an .xcstrings file */
+export interface XCStrings {
+    sourceLanguage: string;
+    version?: string;
+    strings: {
+        [key: string]: StringEntry;
+    };
+}
+/**
+ * Translation input format for the update tool
+ */
+export interface TranslationInput {
+    key: string;
+    translations: {
+        language: string;
+        value: string;
+        state?: LocalizationState;
+    }[];
+    comment?: string;
+}
+export interface TranslationData {
+    data: TranslationInput[];
+}
+/**
+ * Output format for listing translations of a key
+ */
+export interface KeyTranslation {
+    language: string;
+    value: string;
+    state: LocalizationState;
+}
+export interface KeyTranslationsResult {
+    key: string;
+    sourceLanguage: string;
+    translations: KeyTranslation[];
+}

package/dist/types.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Types for Xcode String Catalog (.xcstrings) file format
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidHlwZXMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvdHlwZXMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IjtBQUFBOztHQUVHIiwic291cmNlc0NvbnRlbnQiOlsiLyoqXG4gKiBUeXBlcyBmb3IgWGNvZGUgU3RyaW5nIENhdGFsb2cgKC54Y3N0cmluZ3MpIGZpbGUgZm9ybWF0XG4gKi9cblxuLyoqIFN0YXRlIG9mIGEgbG9jYWxpemF0aW9uIHN0cmluZyAqL1xuZXhwb3J0IHR5cGUgTG9jYWxpemF0aW9uU3RhdGUgPSAnbmV3JyB8ICd0cmFuc2xhdGVkJyB8ICduZWVkc19yZXZpZXcnIHwgJ3N0YWxlJztcblxuLyoqIEEgc2luZ2xlIHN0cmluZyB1bml0IGNvbnRhaW5pbmcgdGhlIHRyYW5zbGF0aW9uIHZhbHVlIGFuZCBzdGF0ZSAqL1xuZXhwb3J0IGludGVyZmFjZSBTdHJpbmdVbml0IHtcbiAgICBzdGF0ZTogTG9jYWxpemF0aW9uU3RhdGU7XG4gICAgdmFsdWU6IHN0cmluZztcbn1cblxuLyoqIExvY2FsaXphdGlvbiBlbnRyeSBmb3IgYSBzaW5nbGUgbGFuZ3VhZ2UgKi9cbmV4cG9ydCBpbnRlcmZhY2UgTG9jYWxpemF0aW9uRW50cnkge1xuICAgIHN0cmluZ1VuaXQ/OiBTdHJpbmdVbml0O1xuICAgIC8qKiBGb3IgcGx1cmFsIHZhcmlhdGlvbnMgKi9cbiAgICB2YXJpYXRpb25zPzoge1xuICAgICAgICBwbHVyYWw/OiB7XG4gICAgICAgICAgICB6ZXJvPzogeyBzdHJpbmdVbml0OiBTdHJpbmdVbml0IH07XG4gICAgICAgICAgICBvbmU/OiB7IHN0cmluZ1VuaXQ6IFN0cmluZ1VuaXQgfTtcbiAgICAgICAgICAgIHR3bz86IHsgc3RyaW5nVW5pdDogU3RyaW5nVW5pdCB9O1xuICAgICAgICAgICAgZmV3PzogeyBzdHJpbmdVbml0OiBTdHJpbmdVbml0IH07XG4gICAgICAgICAgICBtYW55PzogeyBzdHJpbmdVbml0OiBTdHJpbmdVbml0IH07XG4gICAgICAgICAgICBvdGhlcj86IHsgc3RyaW5nVW5pdDogU3RyaW5nVW5pdCB9O1xuICAgICAgICB9O1xuICAgICAgICBkZXZpY2U/OiBSZWNvcmQ8c3RyaW5nLCB7IHN0cmluZ1VuaXQ6IFN0cmluZ1VuaXQgfT47XG4gICAgfTtcbn1cblxuLyoqIEFsbCBsb2NhbGl6YXRpb25zIGZvciBhIHNpbmdsZSBzdHJpbmcga2V5ICovXG5leHBvcnQgaW50ZXJmYWNlIFN0cmluZ0xvY2FsaXphdGlvbnMge1xuICAgIFtsYW5ndWFnZUNvZGU6IHN0cmluZ106IExvY2FsaXphdGlvbkVudHJ5O1xufVxuXG4vKiogQSBzaW5nbGUgc3RyaW5nIGVudHJ5IGluIHRoZSBjYXRhbG9nICovXG5leHBvcnQgaW50ZXJmYWNlIFN0cmluZ0VudHJ5IHtcbiAgICBjb21tZW50Pzogc3RyaW5nO1xuICAgIGV4dHJhY3Rpb25TdGF0ZT86ICdtYW51YWwnIHwgJ2V4dHJhY3RlZF93aXRoX3ZhbHVlJyB8ICdzdGFsZSc7XG4gICAgbG9jYWxpemF0aW9ucz86IFN0cmluZ0xvY2FsaXphdGlvbnM7XG59XG5cbi8qKiBSb290IHN0cnVjdHVyZSBvZiBhbiAueGNzdHJpbmdzIGZpbGUgKi9cbmV4cG9ydCBpbnRlcmZhY2UgWENTdHJpbmdzIHtcbiAgICBzb3VyY2VMYW5ndWFnZTogc3RyaW5nO1xuICAgIHZlcnNpb24/OiBzdHJpbmc7XG4gICAgc3RyaW5nczoge1xuICAgICAgICBba2V5OiBzdHJpbmddOiBTdHJpbmdFbnRyeTtcbiAgICB9O1xufVxuXG4vKipcbiAqIFRyYW5zbGF0aW9uIGlucHV0IGZvcm1hdCBmb3IgdGhlIHVwZGF0ZSB0b29sXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgVHJhbnNsYXRpb25JbnB1dCB7XG4gICAga2V5OiBzdHJpbmc7XG4gICAgdHJhbnNsYXRpb25zOiB7XG4gICAgICAgIGxhbmd1YWdlOiBzdHJpbmc7XG4gICAgICAgIHZhbHVlOiBzdHJpbmc7XG4gICAgICAgIHN0YXRlPzogTG9jYWxpemF0aW9uU3RhdGU7XG4gICAgfVtdO1xuICAgIGNvbW1lbnQ/OiBzdHJpbmc7XG59XG5cbmV4cG9ydCBpbnRlcmZhY2UgVHJhbnNsYXRpb25EYXRhIHtcbiAgICBkYXRhOiBUcmFuc2xhdGlvbklucHV0W107XG59XG5cbi8qKlxuICogT3V0cHV0IGZvcm1hdCBmb3IgbGlzdGluZyB0cmFuc2xhdGlvbnMgb2YgYSBrZXlcbiAqL1xuZXhwb3J0IGludGVyZmFjZSBLZXlUcmFuc2xhdGlvbiB7XG4gICAgbGFuZ3VhZ2U6IHN0cmluZztcbiAgICB2YWx1ZTogc3RyaW5nO1xuICAgIHN0YXRlOiBMb2NhbGl6YXRpb25TdGF0ZTtcbn1cblxuZXhwb3J0IGludGVyZmFjZSBLZXlUcmFuc2xhdGlvbnNSZXN1bHQge1xuICAgIGtleTogc3RyaW5nO1xuICAgIHNvdXJjZUxhbmd1YWdlOiBzdHJpbmc7XG4gICAgdHJhbnNsYXRpb25zOiBLZXlUcmFuc2xhdGlvbltdO1xufVxuIl19

package/eslint.config.js

@@ -0,0 +1,23 @@
+import eslint from '@eslint/js';
+import tseslint from 'typescript-eslint';
+
+export default tseslint.config(
+    eslint.configs.recommended,
+    ...tseslint.configs.recommended,
+    {
+        files: ['src/**/*.ts'],
+        languageOptions: {
+            parserOptions: {
+                project: './tsconfig.json',
+            },
+        },
+        rules: {
+            '@typescript-eslint/no-unused-vars': ['error', { argsIgnorePattern: '^_' }],
+            '@typescript-eslint/no-explicit-any': 'off',
+            '@typescript-eslint/ban-ts-comment': 'off',
+        },
+    },
+    {
+        ignores: ['dist/**', 'node_modules/**'],
+    }
+);

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "string-catalog-mcp",
+  "version": "1.0.0",
+  "type": "module",
+  "description": "MCP server for interacting with Xcode String Catalog (.xcstrings) files",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "string-catalog-mcp": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "tsx src/index.ts",
+    "inspect": "pnpm dlx @modelcontextprotocol/inspector tsx src/index.ts",
+    "mcp:add": "claude mcp add string-catalog-mcp -- pnpm --dir=$PWD dlx tsx $PWD/src/index.ts",
+    "mcp:remove": "claude mcp remove string-catalog-mcp",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src/**/*.ts",
+    "lint:fix": "eslint src/**/*.ts --fix",
+    "format": "prettier --write \"src/**/*.ts\"",
+    "format:check": "prettier --check \"src/**/*.ts\""
+  },
+  "keywords": [
+    "mcp",
+    "xcode",
+    "string-catalog",
+    "xcstrings",
+    "localization",
+    "i18n"
+  ],
+  "author": "Khoa Pham",
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.25.1",
+    "zod": "^4.2.1"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.39.2",
+    "@types/node": "^20.10.0",
+    "@typescript-eslint/eslint-plugin": "^8.50.0",
+    "@typescript-eslint/parser": "^8.50.0",
+    "eslint": "^9.39.2",
+    "prettier": "^3.4.2",
+    "tsx": "^4.19.0",
+    "typescript": "^5.3.0",
+    "typescript-eslint": "^8.50.0"
+  }
+}

package/src/index.ts

@@ -0,0 +1,25 @@
+#!/usr/bin/env node
+
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { registerAllTools } from './mcp/tools/index';
+import { registerAllPrompts } from './mcp/prompts/index';
+
+const server = new McpServer({
+    name: 'string-catalog-mcp',
+    version: '1.0.0',
+});
+
+registerAllTools(server);
+registerAllPrompts(server);
+
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error('String Catalog MCP Server running on stdio');
+}
+
+main().catch((error) => {
+    console.error('Fatal error:', error);
+    process.exit(1);
+});

package/src/mcp/prompts/batch-translate.ts

@@ -0,0 +1,91 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { z } from 'zod';
+
+export function registerBatchTranslatePrompt(server: McpServer) {
+    server.registerPrompt(
+        'batch-translate',
+        {
+            description: 'Translate all untranslated or stale strings in a catalog for specified languages.',
+            argsSchema: {
+                filePath: z.string().describe('Absolute path to the .xcstrings file'),
+                targetLanguages: z.string().describe('Comma-separated list of target language codes (e.g., "de,fr,ja")'),
+                includeStale: z.boolean().default(false).describe('Whether to re-translate stale entries'),
+                batchSize: z.number().default(20).describe('Number of keys to translate per batch (default: 20)'),
+            },
+        },
+        async ({ filePath, targetLanguages, includeStale, batchSize }) => {
+            const targetLangList = targetLanguages.split(',').map(l => l.trim()).filter(Boolean);
+
+            return {
+                messages: [
+                    {
+                        role: 'user',
+                        content: {
+                            type: 'text',
+                            text: `# Batch Translation Request
+
+## String Catalog File
+${filePath}
+
+## Target Languages
+${targetLangList.map(l => `- ${l}`).join('\n')}
+
+## Options
+- Include stale translations: ${includeStale ? 'Yes' : 'No'}
+- Batch size: ${batchSize} keys per batch
+
+## Workflow
+
+### Step 1: Analyze the Catalog
+Use \`get_catalog_statistics\` to understand the current translation coverage.
+
+### Step 2: Identify Keys Needing Translation
+Use \`search_keys\` or \`list_all_keys\` to find:
+- Keys with missing translations for target languages
+${includeStale ? '- Keys with stale translations that need updating' : ''}
+
+### Step 3: Translate in Batches
+For each batch of up to ${batchSize} keys:
+1. Get the source text using \`get_translations_for_key\`
+2. Translate to all target languages
+3. Prepare the JSON payload for \`update_translations\`
+
+## iOS Format Placeholders Reference
+Preserve these placeholders in translations:
+- \`%@\` - String (object)
+- \`%d\` / \`%lld\` - Integer
+- \`%f\` - Float
+- \`%1$@\`, \`%2$@\` - Positional (can reorder for grammar)
+
+## Output Format
+For each batch, provide:
+
+\`\`\`json
+{
+    "data": [
+        {
+            "key": "key_name",
+            "translations": [
+                { "language": "de", "value": "German translation" },
+                { "language": "fr", "value": "French translation" }
+            ]
+        }
+    ]
+}
+\`\`\`
+
+## Instructions
+1. Start by analyzing the catalog
+2. Identify which keys need translation
+3. Process keys in batches
+4. After each batch, use \`update_translations\` to save
+5. Report progress after each batch
+
+Begin the batch translation process now.`,
+                        },
+                    },
+                ],
+            };
+        }
+    );
+}

package/src/mcp/prompts/index.ts

@@ -0,0 +1,10 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { registerTranslateStringsPrompt } from './translate-strings';
+import { registerReviewTranslationsPrompt } from './review-translations';
+import { registerBatchTranslatePrompt } from './batch-translate';
+
+export function registerAllPrompts(server: McpServer) {
+    registerTranslateStringsPrompt(server);
+    registerReviewTranslationsPrompt(server);
+    registerBatchTranslatePrompt(server);
+}

package/src/mcp/prompts/review-translations.ts

@@ -0,0 +1,79 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { z } from 'zod';
+
+export function registerReviewTranslationsPrompt(server: McpServer) {
+    server.registerPrompt(
+        'review-translations',
+        {
+            description: 'Review existing translations for quality, consistency, and proper placeholder usage.',
+            argsSchema: {
+                filePath: z.string().describe('Absolute path to the .xcstrings file'),
+                languages: z.string().optional().describe('Comma-separated list of language codes to review (default: all)'),
+                focusAreas: z.string().optional().describe('Comma-separated areas to focus on (e.g., "placeholders,consistency,tone")'),
+            },
+        },
+        async ({ filePath, languages, focusAreas }) => {
+            const langSection = languages
+                ? `\n## Languages to Review\n${languages.split(',').map(l => `- ${l.trim()}`).join('\n')}\n`
+                : '\n## Languages to Review\nAll available languages in the catalog.\n';
+
+            const focusSection = focusAreas
+                ? `\n## Focus Areas\n${focusAreas.split(',').map(f => `- ${f.trim()}`).join('\n')}\n`
+                : '';
+
+            return {
+                messages: [
+                    {
+                        role: 'user',
+                        content: {
+                            type: 'text',
+                            text: `# Translation Review Request
+
+## String Catalog File
+${filePath}
+${langSection}${focusSection}
+## Review Checklist
+
+### 1. Format Placeholder Verification
+- Ensure all \`%@\`, \`%d\`, \`%lld\`, \`%f\` placeholders are preserved
+- Verify positional arguments (\`%1$@\`, \`%2$@\`) are used correctly
+- Check that placeholder count matches the source string
+
+### 2. Translation Quality
+- Verify translations are accurate and natural-sounding
+- Check for grammatical errors
+- Ensure translations fit the context of a mobile app UI
+
+### 3. Consistency
+- Similar strings should have consistent translations
+- Terminology should be uniform across the app
+- UI element names should match platform conventions
+
+### 4. Cultural Appropriateness
+- Verify idioms are properly localized
+- Check for culturally sensitive content
+- Ensure date/number formats are appropriate
+
+### 5. Length Considerations
+- Flag translations that are significantly longer than source
+- Consider UI space constraints for mobile apps
+
+## Instructions
+1. Use the \`get_catalog_statistics\` tool to see overall translation coverage
+2. Use the \`list_all_keys\` tool to see available keys
+3. Use the \`get_translations_for_key\` tool to examine specific translations
+4. Report any issues found with specific keys and languages
+5. Suggest corrections using the \`update_translations\` tool format
+
+## Output Format
+Provide a structured review report:
+- Summary of findings
+- List of issues by severity (critical, warning, suggestion)
+- Recommended fixes in JSON format for the update_translations tool`,
+                        },
+                    },
+                ],
+            };
+        }
+    );
+}

package/src/mcp/prompts/translate-strings.ts

@@ -0,0 +1,85 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { z } from 'zod';
+
+export function registerTranslateStringsPrompt(server: McpServer) {
+    server.registerPrompt(
+        'translate-strings',
+        {
+            description: 'Generate translations for iOS string catalog keys. Provides guidance on format placeholders and returns structured JSON for the update_translations tool.',
+            argsSchema: {
+                keys: z.string().describe('Comma-separated list of keys to translate (e.g., "hello_world,goodbye,welcome_message")'),
+                sourceLanguage: z.string().default('en').describe('Source language code (default: en)'),
+                targetLanguages: z.string().describe('Comma-separated list of target language codes (e.g., "de,fr,ja,zh-Hans")'),
+                context: z.string().optional().describe('Optional context about where these strings are used in the app'),
+            },
+        },
+        async ({ keys, sourceLanguage, targetLanguages, context }) => {
+            const keyList = keys.split(',').map(k => k.trim()).filter(Boolean);
+            const targetLangList = targetLanguages.split(',').map(l => l.trim()).filter(Boolean);
+
+            const contextSection = context
+                ? `\n## Context\nThese strings are used in: ${context}\n`
+                : '';
+
+            return {
+                messages: [
+                    {
+                        role: 'user',
+                        content: {
+                            type: 'text',
+                            text: `# Translation Request for iOS String Catalog
+
+## Keys to Translate
+${keyList.map(k => `- "${k}"`).join('\n')}
+
+## Source Language
+${sourceLanguage}
+
+## Target Languages
+${targetLangList.map(l => `- ${l}`).join('\n')}
+${contextSection}
+## iOS Format Placeholders
+When translating, preserve these iOS format placeholders exactly as they appear:
+- \`%@\` - String placeholder (objects)
+- \`%d\` or \`%lld\` - Integer placeholder
+- \`%f\` - Floating point number placeholder
+- \`%1$@\`, \`%2$@\` - Positional arguments (order CAN be changed to fit natural language grammar)
+
+## Example
+If source is: "Hello %@, you have %lld items"
+German could be: "Hallo %@, Sie haben %lld Artikel"
+Japanese could be: "%@さん、%lld個のアイテムがあります"
+
+## Instructions
+1. Translate each key into all target languages
+2. Preserve all format placeholders
+3. Ensure translations sound natural in each language
+4. Consider cultural context and localization best practices
+
+## Required Output Format
+Return the translations as JSON that can be used with the \`update_translations\` tool:
+
+\`\`\`json
+{
+    "data": [
+        {
+            "key": "key_name",
+            "translations": [
+                { "language": "en", "value": "English text" },
+                { "language": "de", "value": "German text" },
+                { "language": "fr", "value": "French text" }
+            ],
+            "comment": "Optional: describe where this string is used"
+        }
+    ]
+}
+\`\`\`
+
+Please translate the keys now.`,
+                        },
+                    },
+                ],
+            };
+        }
+    );
+}