Localizable XStrings MCP Server

Instructions

Implementation Reference

• src/localizable_xstrings_mcp/server.py:177-222 (handler)

  The complete handler function for the MCP tool 'apply_missing_tool', including the @mcp.tool() decorator which handles registration. It performs input validation, invokes the core translation logic via apply_missing_translations, formats results including backups and skipped keys, and handles errors.
  @mcp.tool() def apply_missing_tool(file_path: str, target_language: str, app_description: str = "") -> str: """ MCP tool to apply only missing translations for a target language in xcstrings file. Only translates keys that don't already have translations in the target language. Args: file_path (str): Path to the .xcstrings file target_language (str): Target language code app_description (str): Optional description of the app for better translation context Returns: str: Application result with newly 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}" # Apply only missing translations app_desc = app_description if app_description else None applied_translations, backup_path, summary, skipped_keys = apply_missing_translations(file_path, target_language, app_description=app_desc) result = [ f"Summary: {summary}", ] if backup_path: result.append(f"Backup created: {backup_path}") if applied_translations: result.append(f"\nNew translations added ({len(applied_translations)}):") for key, value in applied_translations.items(): result.append(f"{key}: {value}") if skipped_keys: result.append(f"\nSkipped strings ({len(skipped_keys)}):") for key, reason in skipped_keys.items(): result.append(f"{key}: {reason}") return "\n".join(result) except Exception as e: return format_error_message(e, "Failed to apply missing translations")