Localizable XStrings MCP Server

Instructions

MCP tool to translate strings to target language and return translated keys.

Args:
    file_path (str): Path to the .xcstrings file
    target_language (str): Target language code

Returns:
    str: Translation result with translated keys or error message

Implementation Reference

• src/localizable_xstrings_mcp/server.py:76-118 (handler)

  The `translate_tool` function is the main handler for the MCP tool. It is registered via the `@mcp.tool()` decorator and implements the translation logic: validates the xcstrings file and language, fetches base language strings, translates them using `translate_strings`, handles skipped items, and formats the output.

  @mcp.tool()
  def translate_tool(file_path: str, target_language: str) -> str:
      """
      MCP tool to translate strings to target language and return translated keys.
  
      Args:
          file_path (str): Path to the .xcstrings file
          target_language (str): Target language code
  
      Returns:
          str: Translation result with translated keys or error message
      """
      try:
          if not validate_xcstrings_file(file_path):
              return f"Error: Invalid file path or not an .xcstrings file: {file_path}"
  
          if not validate_language_code(target_language):
              return f"Error: Invalid language code: {target_language}"
  
          # Get base keys
          base_keys = get_base_language_strings(file_path)
          if not base_keys:
              return "Error: No base language keys found"
  
          # Translate
          translated, skipped = translate_strings(base_keys, target_language)
          if not translated and not skipped:
              return "Error: Translation failed or returned no results"
  
          result = []
          if translated:
              result.append(f"Translated {len(translated)} strings to {target_language}:")
              for key, value in translated.items():
                  result.append(f"{key}: {value}")
          
          if skipped:
              result.append(f"\nSkipped {len(skipped)} strings:")
              for key, reason in skipped.items():
                  result.append(f"{key}: {reason}")
          
          return "\n".join(result)
      except Exception as e:
          return format_error_message(e, "Translation failed")

• src/localizable_xstrings_mcp/server.py:76-76 (registration)

  The `@mcp.tool()` decorator on line 76 registers the `translate_tool` function as an MCP tool.

  @mcp.tool()