Update tools

Add option to create language
Change create translation key to bulk
Remove single update for translation

Author: jpomykala

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@simplelocalize/simplelocalize-mcp",
-  "version": "0.0.3",
+  "version": "0.1.0",
   "description": "MCP Server for SimpleLocalize",
   "license": "Apache-2.0",
   "repository": "https://github.com/simplelocalize/simplelocalize-mcp-server",

src/api.ts

@@ -1,13 +1,13 @@
 import {
-  createTranslationKey,
-  updateTranslationKey,
+  createTranslationKeyBulk,
   updateTranslationsBulk,
   getAllTranslationKeys,
   getTranslationKeyDetails,
   getTags,
   createTag,
   getLanguages,
   getTranslations,
+  createLanguage,
 } from "./functions.js";
 
 class SimpleLocalizeAPI {
@@ -19,11 +19,11 @@ class SimpleLocalizeAPI {
 
   // eslint-disable-next-line @typescript-eslint/no-explicit-any
   async run(method: string, arg: any) {
-    if (method === "create_translation_key") {
-      const output = JSON.stringify(await createTranslationKey(this.apiKey, arg));
+    if (method === "create_language") {
+      const output = JSON.stringify(await createLanguage(this.apiKey, arg));
       return output;
-    } else if (method === "update_translation_key") {
-      const output = JSON.stringify(await updateTranslationKey(this.apiKey, arg));
+    } else if (method === "create_translation_key_bulk") {
+      const output = JSON.stringify(await createTranslationKeyBulk(this.apiKey, arg));
       return output;
     } else if (method === "update_translations_bulk") {
       const output = JSON.stringify(await updateTranslationsBulk(this.apiKey, arg));

src/functions.ts

@@ -1,21 +1,22 @@
 import { z } from "zod";
 import axios from "axios";
 import {
-  createTranslationKeyParameters,
+  createTranslationKeyBulkParameters,
   updateTranslationKeyParameters,
   updateTranslationsBulkParameters,
   getTranslationKeyDetailsParameters,
   createTagParameters,
   getTranslationsParameters,
+  createLanguageParameters,
 } from "./parameters.js";
 
 const BASE_URL = "https://api.simplelocalize.io";
 const CLIENT_NAME = "mcp-server";
 
-export const createTranslationKey = async (apiKey: string, params: z.infer<typeof createTranslationKeyParameters>) => {
+export const createTranslationKeyBulk = async (apiKey: string, params: z.infer<typeof createTranslationKeyBulkParameters>) => {
   try {
     const response = await axios.post(
-      `${BASE_URL}/api/v1/translation-keys`,
+      `${BASE_URL}/api/v1/translation-keys/bulk`,
       params,
       {
         headers: {
@@ -30,25 +31,6 @@ export const createTranslationKey = async (apiKey: string, params: z.infer<typeo
   }
 };
 
-export const updateTranslationKey = async (apiKey: string, params: z.infer<typeof updateTranslationKeyParameters>) => {
-  try {
-    const { key, namespace, ...body } = params;
-    const response = await axios.patch(
-      `${BASE_URL}/api/v1/translation-keys?key=${encodeURIComponent(key)}${namespace ? `&namespace=${encodeURIComponent(namespace)}` : ""}`,
-      body,
-      {
-        headers: {
-          "X-SimpleLocalize-Token": apiKey,
-          "X-SimpleLocalize-Client": CLIENT_NAME,
-        },
-      }
-    );
-    return response?.data;
-  } catch (error) {
-    return error;
-  }
-};
-
 export const updateTranslationsBulk = async (apiKey: string, params: z.infer<typeof updateTranslationsBulkParameters>) => {
   try {
     const response = await axios.patch(
@@ -171,3 +153,21 @@ export const getTranslations = async (apiKey: string, params: z.infer<typeof get
     return error;
   }
 };
+
+export const createLanguage = async (apiKey: string, params: z.infer<typeof createLanguageParameters>) => {
+  try {
+    const response = await axios.post(
+      `${BASE_URL}/api/v1/languages`,
+      params,
+      {
+        headers: {
+          "X-SimpleLocalize-Token": apiKey,
+          "X-SimpleLocalize-Client": CLIENT_NAME,
+        },
+      }
+    );
+    return response?.data;
+  } catch (error) {
+    return error;
+  }
+};

src/parameters.ts

@@ -1,12 +1,14 @@
 import { z } from "zod";
 
-export const createTranslationKeyParameters = z.object({
-  key: z.string().describe("The translation key name. Must be unique within the namespace."),
-  namespace: z.string().optional().describe("The namespace for the translation key. Defaults to an empty string if not provided."),
-  description: z.string().optional().describe("A description of the translation key."),
-  codeDescription: z.string().optional().describe("A description of the code context for the translation key."),
-  tags: z.array(z.string().describe("A tag for the translation key.")).optional().describe("Tags to categorize the translation key."),
-  charactersLimit: z.number().min(-1).optional().describe("The character limit for the translation key value. -1 means unlimited."),
+export const createTranslationKeyBulkParameters = z.object({
+  translationKeys: z.array(z.object({
+    key: z.string().describe("The translation key name. Must be unique within the namespace."),
+    namespace: z.string().optional().describe("The namespace for the translation key. Defaults to an empty string if not provided."),
+    description: z.string().optional().describe("A description of the translation key."),
+    codeDescription: z.string().optional().describe("A description of the code context for the translation key."),
+    tags: z.array(z.string().describe("A tag for the translation key.")).optional().describe("Tags to categorize the translation key."),
+    charactersLimit: z.number().min(-1).optional().describe("The character limit for the translation key value. -1 means unlimited."),
+  })).max(100).describe("Array of translation keys to create (max 100)."),
 });
 
 export const updateTranslationKeyParameters = z.object({
@@ -45,6 +47,11 @@ export const createTagParameters = z.object({
 
 export const getLanguagesParameters = z.object({}).describe("No parameters required.");
 
+export const createLanguageParameters = z.object({
+  key: z.string().describe("The language key (e.g. en, pl_PL)."),
+  name: z.string().optional().describe("The language name (optional, e.g. English, Polish)."),
+});
+
 export const getTranslationsParameters = z.object({
   key: z.string().optional().describe("Filter by translation key name."),
   namespace: z.string().optional().describe("Filter by namespace."),

src/prompts.ts

@@ -1,15 +1,8 @@
 export const createTranslationKeyPrompt = `
-This tool will create a new translation key in your SimpleLocalize project.
-- 'key' is required and must be unique within the namespace.
-- 'namespace', 'description', 'codeDescription', 'tags', and 'charactersLimit' are optional.
-- Use 'charactersLimit' to restrict the length of translation values, or set to -1 for unlimited.
-`;
-
-export const updateTranslationKeyPrompt = `
-This tool will update an existing translation key in your SimpleLocalize project.
-- Provide 'key' (required) and optionally 'namespace'.
-- You can update 'description', 'codeDescription', 'tags', and 'charactersLimit'.
-- Fields left empty or null will not be updated.
+This tool will create multiple translation keys in your SimpleLocalize project in bulk.
+- Provide an array of translation key objects (max 100).
+- Each object must include 'key' and can include 'namespace', 'description', 'codeDescription', 'tags', and 'charactersLimit'.
+- It doesn't throw an error if translation key already exists, but it returns a list of failures.
 `;
 
 export const updateTranslationsBulkPrompt = `
@@ -56,3 +49,9 @@ This tool will list translations in your SimpleLocalize project.
 - Supports pagination with 'page' and 'size'.
 - Use 'text' to search for translations containing a specific value (min 3 characters).
 `;
+
+export const createLanguagePrompt = `
+This tool will create a new language in your SimpleLocalize project.
+- 'key' is required and must be a valid language key (e.g. en, pl_PL).
+- 'name' is optional and can be used to provide a display name for the language.
+`;

src/tools.ts

@@ -1,25 +1,25 @@
 import { z } from "zod";
 import {
-  createTranslationKeyParameters,
-  updateTranslationKeyParameters,
+  createTranslationKeyBulkParameters,
   updateTranslationsBulkParameters,
   getAllTranslationKeysParameters,
   getTranslationKeyDetailsParameters,
   getTagsParameters,
   createTagParameters,
   getLanguagesParameters,
   getTranslationsParameters,
+  createLanguageParameters,
 } from "./parameters.js";
 import {
   createTranslationKeyPrompt,
-  updateTranslationKeyPrompt,
   updateTranslationsBulkPrompt,
   getAllTranslationKeysPrompt,
   getTranslationKeyDetailsPrompt,
   getTagsPrompt,
   createTagPrompt,
   getLanguagesPrompt,
   getTranslationsPrompt,
+  createLanguagePrompt,
 } from "./prompts.js";
 
 export type Tool = {
@@ -37,17 +37,10 @@ export type Tool = {
 
 const tools: Tool[] = [
   {
-    method: "create_translation_key",
-    name: "Create Translation Key",
+    method: "create_translation_key_bulk",
+    name: "Create Translation Key Bulk",
     description: createTranslationKeyPrompt,
-    parameters: createTranslationKeyParameters,
-    actions: { translationKeys: { write: true } },
-  },
-  {
-    method: "update_translation_key",
-    name: "Update Translation Key",
-    description: updateTranslationKeyPrompt,
-    parameters: updateTranslationKeyParameters,
+    parameters: createTranslationKeyBulkParameters,
     actions: { translationKeys: { write: true } },
   },
   {
@@ -92,6 +85,13 @@ const tools: Tool[] = [
     parameters: getLanguagesParameters,
     actions: { languages: { read: true } },
   },
+  {
+    method: "create_language",
+    name: "Create Language",
+    description: createLanguagePrompt,
+    parameters: createLanguageParameters,
+    actions: { languages: { write: true } },
+  },
   {
     method: "get_translations",
     name: "Get Translations",