translate_text

Instructions

⚠️ COST WARNING: This tool makes an API call to Whissle which may incur costs. Only use when explicitly requested by the user.

Args:
    text (str): The text to translate
    source_language (str): Source language code (e.g., "en" for English)
    target_language (str): Target language code (e.g., "es" for Spanish)

Returns:
    TextContent with the translated text.

Implementation Reference

• whissle_mcp/server.py:330-381 (handler)

  The handler function implementing the translate_text tool. It performs text translation using the Whissle API's machine_translation method, includes logging, error handling with retries using handle_api_error, and returns formatted TextContent.

  def translate_text(
      text: str,
      source_language: str,
      target_language: str,
  ) -> TextContent:
      try:
          if not text:
              logger.error("Empty text provided for translation")
              return make_error("Text is required")
          
          # Log the request details
          logger.info(f"Translating text from {source_language} to {target_language}")
          logger.info(f"Text length: {len(text)} characters")
          
          retry_count = 0
          max_retries = 2  # Increased from 1 to 2
          
          while retry_count <= max_retries:
              try:
                  logger.info(f"Attempting translation (Attempt {retry_count+1}/{max_retries+1})")
                  response = client.machine_translation(
                      text=text,
                      source_language=source_language,
                      target_language=target_language,
                  )
                  
                  if response and response.translated_text:
                      logger.info("Translation successful")
                      return TextContent(
                          type="text",
                          text=f"Translation:\n{response.translated_text}",
                      )
                  else:
                      logger.error("No translation was returned from the API")
                      return make_error("No translation was returned from the API")
              except Exception as api_error:
                  error_msg = str(api_error)
                  logger.error(f"Translation error: {error_msg}")
                  
                  # Handle API errors with retries
                  error_result = handle_api_error(error_msg, "translation", retry_count, max_retries)
                  if error_result is not None:  # If we should not retry
                      return error_result  # Return the error message
                  
                  retry_count += 1
          
          # If we get here, all retries failed
          logger.error(f"All translation attempts failed after {max_retries+1} attempts")
          return make_error(f"Failed to translate text after {max_retries+1} attempts")
      except Exception as e:
          logger.error(f"Unexpected error during translation: {str(e)}")
          return make_error(f"Failed to translate text: {str(e)}")

• whissle_mcp/server.py:316-329 (registration)

  Registration of the 'translate_text' tool using the @mcp.tool decorator. Includes the tool description, input schema (args: text, source_language, target_language), cost warning, and return type.

  @mcp.tool(
      description="""Translate text from one language to another.
  
      ⚠️ COST WARNING: This tool makes an API call to Whissle which may incur costs. Only use when explicitly requested by the user.
  
      Args:
          text (str): The text to translate
          source_language (str): Source language code (e.g., "en" for English)
          target_language (str): Target language code (e.g., "es" for Spanish)
  
      Returns:
          TextContent with the translated text.
      """
  )