SimpleLocalize MCP Server

Instructions

Implementation Reference

• main.py:207-313 (handler)

  The main handler function for the 'duplicate_translation' tool. It is decorated with @mcp.tool(), which registers it as an MCP tool. The function copies translations from a source key/namespace to a destination key/namespace by fetching existing translations via API, creating the destination key if necessary, and bulk-updating the translations using the SimpleLocalize API.

  @mcp.tool()
  async def duplicate_translation(from_dict: dict, to_dict: dict) -> str:
      """Duplicate translations from one key/namespace to another key/namespace.
      
      This function copies all translations for a specific key (and optionally namespace)
      to another key (and optionally namespace). Useful for duplicating translations
      when creating similar keys or reorganizing translations.
      
      Args:
          from_dict: Source dictionary with fields:
              - key (required): Source translation key
              - namespace (optional): Source namespace
          to_dict: Destination dictionary with fields:
              - key (required): Destination translation key
              - namespace (optional): Destination namespace
      
      Returns:
          String message indicating success or failure
      """
      # Validate input
      if not from_dict.get("key"):
          raise ValueError("Source dictionary must have a 'key' field")
      if not to_dict.get("key"):
          raise ValueError("Destination dictionary must have a 'key' field")
      
      source_key = from_dict["key"]
      source_namespace = from_dict.get("namespace", "")
      dest_key = to_dict["key"]
      dest_namespace = to_dict.get("namespace", "")
      
      try:
          # Step 1: Get all translations from the source
          result = await make_simplelocalize_request(
              "GET",
              "/api/v2/translations"
          )
          
          data = result.get("data", [])
          
          # Filter for translations matching the source key/namespace
          source_translations = []
          for item in data:
              key = item.get("key", "")
              namespace = item.get("namespace", "")
              language = item.get("language", "")
              text = item.get("text", "")
              
              # Check if this matches our source key/namespace
              if key == source_key and namespace == source_namespace and text:
                  source_translations.append({
                      "language": language,
                      "text": text
                  })
          
          if not source_translations:
              return f"No translations found for key '{source_key}'" + (f" in namespace '{source_namespace}'" if source_namespace else "")
          
          # Step 2: Create the destination key if it doesn't exist
          create_key_payload = {
              "key": dest_key
          }
          if dest_namespace:
              create_key_payload["namespace"] = dest_namespace
          
          # Try to create the key (will fail silently if it already exists)
          try:
              await make_simplelocalize_request(
                  "POST",
                  "/api/v1/translation-keys/bulk",
                  {"translationKeys": [create_key_payload]}
              )
          except SimpleLocalizeError:
              # Key might already exist, continue
              pass
          
          # Step 3: Copy all translations to the destination
          translations_to_update = []
          for trans in source_translations:
              update_payload = {
                  "key": dest_key,
                  "language": trans["language"],
                  "text": trans["text"]
              }
              if dest_namespace:
                  update_payload["namespace"] = dest_namespace
              translations_to_update.append(update_payload)
          
          # Update translations in bulk
          update_result = await make_simplelocalize_request(
              "PATCH",
              "/api/v2/translations/bulk",
              {"translations": translations_to_update}
          )
          
          if "failures" in update_result.get("data", {}):
              failures = update_result["data"]["failures"]
              if failures:
                  return f"Some translations failed to duplicate: {failures}"
          
          source_desc = f"'{source_key}'" + (f" (namespace: '{source_namespace}')" if source_namespace else "")
          dest_desc = f"'{dest_key}'" + (f" (namespace: '{dest_namespace}')" if dest_namespace else "")
          
          return f"Successfully duplicated {len(translations_to_update)} translation(s) from {source_desc} to {dest_desc}"
          
      except SimpleLocalizeError as e:
          return str(e)