@better-i18n/mcp-server 0.1.0

package/dist/tools/bulkCreateKeys.js

@@ -0,0 +1,113 @@
+/**
+ * bulkCreateKeys MCP Tool
+ *
+ * Creates multiple translation keys with all translations in a single request.
+ * Perfect for adding entire components or pages worth of translations at once.
+ */
+import { z } from "zod";
+const inputSchema = z.object({
+    projectSlug: z.string().optional(),
+    keys: z.array(z.object({
+        key: z.string(),
+        namespace: z.string().optional(),
+        sourceText: z.string(),
+        translations: z.record(z.string(), z.string()).optional(),
+    })),
+});
+export const bulkCreateKeys = {
+    definition: {
+        name: "bulkCreateKeys",
+        description: "Create multiple translation keys with their translations in a single request. Use this when adding translations for an entire component or page. Each key can have sourceText (English) and translations for other languages.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                projectSlug: {
+                    type: "string",
+                    description: "Project slug (optional if i18n.config.ts exists)",
+                },
+                keys: {
+                    type: "array",
+                    description: "Array of translation keys to create",
+                    items: {
+                        type: "object",
+                        properties: {
+                            key: {
+                                type: "string",
+                                description: "Translation key (e.g., 'nav.features')",
+                            },
+                            namespace: {
+                                type: "string",
+                                description: "Namespace (e.g., 'nav', 'home'). Defaults to 'default'",
+                            },
+                            sourceText: {
+                                type: "string",
+                                description: "English source text",
+                            },
+                            translations: {
+                                type: "object",
+                                description: "Translations for other languages. Keys are language codes (tr, de, fr), values are translated text",
+                            },
+                        },
+                        required: ["key", "sourceText"],
+                    },
+                },
+            },
+            required: ["keys"],
+        },
+    },
+    async execute(client, args, context) {
+        const input = inputSchema.parse(args);
+        const projectSlug = input.projectSlug || context.projectContext?.projectSlug;
+        const orgSlug = context.projectContext?.workspaceId;
+        if (!projectSlug || !orgSlug) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: "Error: Project not specified and no i18n.config.ts found in workspace",
+                    },
+                ],
+                isError: true,
+            };
+        }
+        try {
+            // Format keys with default namespace
+            const formattedKeys = input.keys.map(k => ({
+                key: k.key,
+                namespace: k.namespace || "default",
+                sourceText: k.sourceText,
+                translations: k.translations,
+            }));
+            const result = await client.mcp.bulkCreateKeys.mutate({
+                orgSlug,
+                projectSlug,
+                keys: formattedKeys,
+            });
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            success: true,
+                            project: `${orgSlug}/${projectSlug}`,
+                            keysCreated: result.keysCreated,
+                            keys: result.keys,
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error creating translation keys: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    },
+};
+//# sourceMappingURL=bulkCreateKeys.js.map

package/dist/tools/bulkCreateKeys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bulkCreateKeys.js","sourceRoot":"","sources":["../../src/tools/bulkCreateKeys.ts"],"names":[],"mappings":"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"}

package/dist/tools/bulkUpdateTranslations.d.ts

@@ -0,0 +1,9 @@
+/**
+ * bulkUpdateTranslations MCP Tool
+ *
+ * Updates translations for multiple keys in a single request.
+ * Perfect for batch updating translations across multiple languages.
+ */
+import type { Tool } from "../types/index.js";
+export declare const bulkUpdateTranslations: Tool;
+//# sourceMappingURL=bulkUpdateTranslations.d.ts.map

package/dist/tools/bulkUpdateTranslations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bulkUpdateTranslations.d.ts","sourceRoot":"","sources":["../../src/tools/bulkUpdateTranslations.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAW9C,eAAO,MAAM,sBAAsB,EAAE,IAqGpC,CAAC"}

package/dist/tools/bulkUpdateTranslations.js

@@ -0,0 +1,107 @@
+/**
+ * bulkUpdateTranslations MCP Tool
+ *
+ * Updates translations for multiple keys in a single request.
+ * Perfect for batch updating translations across multiple languages.
+ */
+import { z } from "zod";
+const inputSchema = z.object({
+    projectSlug: z.string().optional(),
+    updates: z.array(z.object({
+        key: z.string(),
+        namespace: z.string().optional(),
+        translations: z.record(z.string(), z.string()),
+    })),
+});
+export const bulkUpdateTranslations = {
+    definition: {
+        name: "bulkUpdateTranslations",
+        description: "Update translations for multiple keys in a single request. Use this when adding or updating translations for several keys at once. Each update specifies the key and translations for target languages.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                projectSlug: {
+                    type: "string",
+                    description: "Project slug (optional if i18n.config.ts exists)",
+                },
+                updates: {
+                    type: "array",
+                    description: "Array of translation updates",
+                    items: {
+                        type: "object",
+                        properties: {
+                            key: {
+                                type: "string",
+                                description: "Translation key to update",
+                            },
+                            namespace: {
+                                type: "string",
+                                description: "Namespace (e.g., 'nav', 'home'). Defaults to 'default'",
+                            },
+                            translations: {
+                                type: "object",
+                                description: "Translations for target languages. Keys are language codes (tr, de, fr), values are translated text",
+                            },
+                        },
+                        required: ["key", "translations"],
+                    },
+                },
+            },
+            required: ["updates"],
+        },
+    },
+    async execute(client, args, context) {
+        const input = inputSchema.parse(args);
+        const projectSlug = input.projectSlug || context.projectContext?.projectSlug;
+        const orgSlug = context.projectContext?.workspaceId;
+        if (!projectSlug || !orgSlug) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: "Error: Project not specified and no i18n.config.ts found in workspace",
+                    },
+                ],
+                isError: true,
+            };
+        }
+        try {
+            // Format updates with default namespace
+            const formattedUpdates = input.updates.map(u => ({
+                key: u.key,
+                namespace: u.namespace || "default",
+                translations: u.translations,
+            }));
+            const result = await client.mcp.bulkUpdateTranslations.mutate({
+                orgSlug,
+                projectSlug,
+                updates: formattedUpdates,
+            });
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            success: true,
+                            project: `${orgSlug}/${projectSlug}`,
+                            keysUpdated: result.keysUpdated,
+                            updates: result.updates,
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error updating translations: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    },
+};
+//# sourceMappingURL=bulkUpdateTranslations.js.map

package/dist/tools/bulkUpdateTranslations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bulkUpdateTranslations.js","sourceRoot":"","sources":["../../src/tools/bulkUpdateTranslations.ts"],"names":[],"mappings":"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"}

package/dist/tools/createTranslationKey.d.ts

@@ -0,0 +1,9 @@
+/**
+ * createTranslationKey MCP Tool
+ *
+ * Creates a new translation key with source text in the default language.
+ * Uses the MCP-specific API that works with org/project slugs.
+ */
+import type { Tool } from "../types/index.js";
+export declare const createTranslationKey: Tool;
+//# sourceMappingURL=createTranslationKey.d.ts.map

package/dist/tools/createTranslationKey.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createTranslationKey.d.ts","sourceRoot":"","sources":["../../src/tools/createTranslationKey.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAS9C,eAAO,MAAM,oBAAoB,EAAE,IA0FlC,CAAC"}

package/dist/tools/createTranslationKey.js

@@ -0,0 +1,95 @@
+/**
+ * createTranslationKey MCP Tool
+ *
+ * Creates a new translation key with source text in the default language.
+ * Uses the MCP-specific API that works with org/project slugs.
+ */
+import { z } from "zod";
+const inputSchema = z.object({
+    projectSlug: z.string().optional(),
+    key: z.string().min(1),
+    sourceValue: z.string().min(1),
+    namespace: z.string().optional(),
+});
+export const createTranslationKey = {
+    definition: {
+        name: "createTranslationKey",
+        description: "Create a new translation key with source text. Namespace is auto-extracted from the key if it contains dots (e.g., 'auth.login' → namespace: 'auth'). If projectSlug is not provided, uses the project from i18n.config.ts in the workspace.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                projectSlug: {
+                    type: "string",
+                    description: "Project slug (optional if i18n.config.ts exists)",
+                },
+                key: {
+                    type: "string",
+                    description: "Translation key (e.g., 'auth.login.title', 'home.hero.cta')",
+                },
+                sourceValue: {
+                    type: "string",
+                    description: "Source text in default language (usually English)",
+                },
+                namespace: {
+                    type: "string",
+                    description: "Optional explicit namespace override",
+                },
+            },
+            required: ["key", "sourceValue"],
+        },
+    },
+    async execute(client, args, context) {
+        const input = inputSchema.parse(args);
+        // Get project slug from args or context
+        const projectSlug = input.projectSlug || context.projectContext?.projectSlug;
+        const orgSlug = context.projectContext?.workspaceId;
+        if (!projectSlug || !orgSlug) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: "Error: Project not specified and no i18n.config.ts found in workspace. Please provide projectSlug or run from a directory with i18n.config.ts",
+                    },
+                ],
+                isError: true,
+            };
+        }
+        try {
+            // Use MCP-specific endpoint with slug-based lookup
+            const result = await client.mcp.createKey.mutate({
+                orgSlug,
+                projectSlug,
+                key: input.key,
+                namespace: input.namespace || "default",
+                sourceText: input.sourceValue,
+            });
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            success: true,
+                            keyId: result.keyId,
+                            key: input.key,
+                            namespace: input.namespace || "default",
+                            sourceText: input.sourceValue,
+                            project: `${orgSlug}/${projectSlug}`,
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error creating translation key: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    },
+};
+//# sourceMappingURL=createTranslationKey.js.map

package/dist/tools/createTranslationKey.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createTranslationKey.js","sourceRoot":"","sources":["../../src/tools/createTranslationKey.ts"],"names":[],"mappings":"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"}

package/dist/tools/getProjectInfo.d.ts

@@ -0,0 +1,9 @@
+/**
+ * getProjectInfo MCP Tool
+ *
+ * Gets project information including available namespaces, languages, and stats.
+ * Useful for understanding the project structure before adding translations.
+ */
+import type { Tool } from "../types/index.js";
+export declare const getProjectInfo: Tool;
+//# sourceMappingURL=getProjectInfo.d.ts.map

package/dist/tools/getProjectInfo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getProjectInfo.d.ts","sourceRoot":"","sources":["../../src/tools/getProjectInfo.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAM9C,eAAO,MAAM,cAAc,EAAE,IA6D5B,CAAC"}

package/dist/tools/getProjectInfo.js

@@ -0,0 +1,67 @@
+/**
+ * getProjectInfo MCP Tool
+ *
+ * Gets project information including available namespaces, languages, and stats.
+ * Useful for understanding the project structure before adding translations.
+ */
+import { z } from "zod";
+const inputSchema = z.object({
+    projectSlug: z.string().optional(),
+});
+export const getProjectInfo = {
+    definition: {
+        name: "getProjectInfo",
+        description: "Get project information including available namespaces, languages, and key count. Use this to understand the project structure before adding or updating translations.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                projectSlug: {
+                    type: "string",
+                    description: "Project slug (optional if i18n.config.ts exists)",
+                },
+            },
+        },
+    },
+    async execute(client, args, context) {
+        const input = inputSchema.parse(args);
+        const projectSlug = input.projectSlug || context.projectContext?.projectSlug;
+        const orgSlug = context.projectContext?.workspaceId;
+        if (!projectSlug || !orgSlug) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: "Error: Project not specified and no i18n.config.ts found in workspace",
+                    },
+                ],
+                isError: true,
+            };
+        }
+        try {
+            const result = await client.mcp.getProjectInfo.query({
+                orgSlug,
+                projectSlug,
+            });
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify(result, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error getting project info: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    },
+};
+//# sourceMappingURL=getProjectInfo.js.map

package/dist/tools/getProjectInfo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getProjectInfo.js","sourceRoot":"","sources":["../../src/tools/getProjectInfo.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACnC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,cAAc,GAAS;IAClC,UAAU,EAAE;QACV,IAAI,EAAE,gBAAgB;QACtB,WAAW,EACT,wKAAwK;QAC1K,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,WAAW,EAAE;oBACX,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,kDAAkD;iBAChE;aACF;SACF;KACF;IAED,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO;QACjC,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAEtC,MAAM,WAAW,GACf,KAAK,CAAC,WAAW,IAAI,OAAO,CAAC,cAAc,EAAE,WAAW,CAAC;QAC3D,MAAM,OAAO,GAAG,OAAO,CAAC,cAAc,EAAE,WAAW,CAAC;QAEpD,IAAI,CAAC,WAAW,IAAI,CAAC,OAAO,EAAE,CAAC;YAC7B,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,uEAAuE;qBAC9E;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,cAAc,CAAC,KAAK,CAAC;gBACnD,OAAO;gBACP,WAAW;aACZ,CAAC,CAAC;YAEH,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;qBACtC;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,+BAA+B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;qBAC9F;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/tools/listKeys.d.ts

@@ -0,0 +1,9 @@
+/**
+ * listKeys MCP Tool
+ *
+ * Lists translation keys in a project with optional filtering.
+ * Uses the MCP-specific API that works with org/project slugs.
+ */
+import type { Tool } from "../types/index.js";
+export declare const listKeys: Tool;
+//# sourceMappingURL=listKeys.d.ts.map

package/dist/tools/listKeys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"listKeys.d.ts","sourceRoot":"","sources":["../../src/tools/listKeys.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAW9C,eAAO,MAAM,QAAQ,EAAE,IA2GtB,CAAC"}

package/dist/tools/listKeys.js

@@ -0,0 +1,113 @@
+/**
+ * listKeys MCP Tool
+ *
+ * Lists translation keys in a project with optional filtering.
+ * Uses the MCP-specific API that works with org/project slugs.
+ */
+import { z } from "zod";
+const inputSchema = z.object({
+    projectSlug: z.string().optional(),
+    search: z.string().optional(),
+    namespaces: z.array(z.string()).optional(),
+    missingLanguage: z.string().optional(),
+    page: z.number().min(1).default(1),
+    limit: z.number().min(1).max(100).default(50),
+});
+export const listKeys = {
+    definition: {
+        name: "listKeys",
+        description: "List translation keys with optional search, namespace filter, and missing translation filter. Each key includes sourceText and all translations with their language codes.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                projectSlug: {
+                    type: "string",
+                    description: "Project slug (optional if i18n.config.ts exists)",
+                },
+                search: {
+                    type: "string",
+                    description: "Search query for keys (e.g., 'nav' to find nav.home, nav.features)",
+                },
+                namespaces: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "Filter by specific namespaces (e.g., ['nav', 'home'])",
+                },
+                missingLanguage: {
+                    type: "string",
+                    description: "Find keys that don't have a translation for this language code (e.g., 'tr' to find keys missing Turkish)",
+                },
+                page: {
+                    type: "number",
+                    description: "Page number (default: 1)",
+                },
+                limit: {
+                    type: "number",
+                    description: "Results per page (default: 50, max: 100)",
+                },
+            },
+        },
+    },
+    async execute(client, args, context) {
+        const input = inputSchema.parse(args);
+        // Get project slug from args or context
+        const projectSlug = input.projectSlug || context.projectContext?.projectSlug;
+        const orgSlug = context.projectContext?.workspaceId;
+        if (!projectSlug || !orgSlug) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: "Error: Project not specified and no i18n.config.ts found in workspace",
+                    },
+                ],
+                isError: true,
+            };
+        }
+        try {
+            // Use MCP-specific endpoint with slug-based lookup
+            const result = await client.mcp.listKeys.query({
+                orgSlug,
+                projectSlug,
+                search: input.search,
+                namespaces: input.namespaces,
+                missingLanguage: input.missingLanguage,
+                page: input.page,
+                limit: input.limit,
+            });
+            // Format the response
+            const summary = {
+                project: `${orgSlug}/${projectSlug}`,
+                page: input.page,
+                limit: input.limit,
+                total: result.total,
+                totalPages: Math.ceil(result.total / input.limit),
+                keysCount: result.keys.length,
+                ...(input.missingLanguage && { missingLanguage: input.missingLanguage }),
+            };
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            summary,
+                            keys: result.keys,
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error listing keys: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    },
+};
+//# sourceMappingURL=listKeys.js.map

package/dist/tools/listKeys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"listKeys.js","sourceRoot":"","sources":["../../src/tools/listKeys.ts"],"names":[],"mappings":"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"}

package/dist/tools/updateTranslation.d.ts

@@ -0,0 +1,9 @@
+/**
+ * updateTranslation MCP Tool
+ *
+ * Updates or creates a translation for a specific language.
+ * Uses the MCP-specific API that works with org/project slugs.
+ */
+import type { Tool } from "../types/index.js";
+export declare const updateTranslation: Tool;
+//# sourceMappingURL=updateTranslation.d.ts.map

package/dist/tools/updateTranslation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"updateTranslation.d.ts","sourceRoot":"","sources":["../../src/tools/updateTranslation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAU9C,eAAO,MAAM,iBAAiB,EAAE,IA+F/B,CAAC"}