All Voice Lab MCP Server

Instructions

This tool translates text content from a file to a specified target language. The process runs asynchronously
with status polling and returns the translated text when complete.

Args:
    file_path: Path to the text file to translate. Only TXT and SRT formats are supported. Maximum file size: 10MB.
    target_lang: Target language code for translation (e.g., 'zh', 'en', 'ja', 'fr', 'de', 'ko'). Required.
    source_lang: Source language code of the original content. Set to 'auto' for automatic language detection. Default is 'auto'.
    output_dir: Output directory for the downloaded result file. Default is user's desktop.

Returns:
    TextContent containing the file path to the translated file or error message.
    If the process takes longer than expected, returns the project ID for later status checking. 

Limitations:
    - Only TXT and SRT formats are supported
    - Maximum file size: 10MB
    - File must exist and be accessible
    - Currently supports a limited set of languages for translation

Implementation Reference

• allvoicelab_mcp/tools/text_translation.py:12-189 (handler)

  The main handler function for the 'text_translation' tool. Validates input file (TXT/SRT, <=10MB), submits translation task to AllVoiceLab API, polls status up to 10 minutes, downloads result if successful, saves to output_dir, and returns formatted TextContent with translation details and file path.

  def text_translation_tool(
      file_path: str,
      target_lang: str,
      source_lang: str = "auto",
      output_dir: str = None
  ) -> TextContent:
      all_voice_lab = get_client()
      output_dir = all_voice_lab.get_output_path(output_dir)
      max_polling_time = 600
      polling_interval = 10
      logging.info(
          f"Tool called: text_translation, file_path: {file_path}, target_lang: {target_lang}, source_lang: {source_lang}")
      logging.info(f"Max polling time: {max_polling_time}s, Polling interval: {polling_interval}s")
  
      
      if not file_path:
          logging.warning("File path parameter is empty")
          return TextContent(
              type="text",
              text="file_path parameter cannot be empty"
          )
  
      
      if not os.path.exists(file_path):
          logging.warning(f"File does not exist: {file_path}")
          return TextContent(
              type="text",
              text=f"File does not exist: {file_path}"
          )
  
      
      _, file_extension = os.path.splitext(file_path)
      file_extension = file_extension.lower()
      if file_extension not in [".txt", ".srt"]:
          logging.warning(f"Unsupported file format: {file_extension}")
          return TextContent(
              type="text",
              text=f"Unsupported file format. Only TXT and SRT formats are supported."
          )
  
      
      max_size_bytes = 10 * 1024 * 1024  # 10MB in bytes
      file_size = os.path.getsize(file_path)
      if file_size > max_size_bytes:
          logging.warning(f"File size exceeds limit: {file_size} bytes, max allowed: {max_size_bytes} bytes")
          return TextContent(
              type="text",
              text=f"File size exceeds the maximum limit of 10MB. Please use a smaller file."
          )
  
      try:
          if all_voice_lab is None:
              logging.error("all_voice_lab client is not initialized.")
              return TextContent(type="text",
                                 text="Error: AllVoiceLab client not initialized. Please check server setup.")
  
          
          logging.info("Starting text translation process")
          project_id = all_voice_lab.text_translation(
              file_path=file_path,
              target_lang=target_lang,
              source_lang=source_lang
          )
          logging.info(f"Text translation task submitted. Project ID: {project_id}")
  
          
          logging.info(f"Starting to poll translation status for Project ID: {project_id}")
          start_time = time.time()
          completed = False
  
          
          while time.time() - start_time < max_polling_time:
              try:
                  
                  translation_result = all_voice_lab.get_text_translation_result(project_id)
                  if translation_result is None:
                      logging.warning(f"Failed to get translation result for Project ID: {project_id}")
                      time.sleep(polling_interval)
                      continue
  
                  logging.info(f"Translation status: {translation_result.status} for Project ID: {project_id}")
  
                  
                  if translation_result.status.lower() == "success":
                      logging.info(f"Text translation completed for Project ID: {project_id}")
                      completed = True
  
                      
                      if translation_result.result and translation_result.result.startswith("http"):
                          try:
                              
                              os.makedirs(output_dir, exist_ok=True)
  
                              
                              # Get original filename without extension
                              original_filename = os.path.splitext(os.path.basename(file_path))[0]
                              timestamp = int(time.time())
                              random_suffix = ''.join(random.choices('abcdefghijklmnopqrstuvwxyz0123456789', k=6))
                              filename = f"{original_filename}_translation_{timestamp}_{random_suffix}.txt"
                              file_path = os.path.join(output_dir, filename)
  
                              
                              logging.info(f"Downloading translation result from URL: {translation_result.result}")
                              response = requests.get(translation_result.result, timeout=30)
                              response.raise_for_status()
  
                              
                              with open(file_path, 'wb') as f:
                                  f.write(response.content)
  
                              
                              with open(file_path, 'r', encoding='utf-8') as f:
                                  translated_text = f.read()
  
                              logging.info(f"Translation result downloaded and saved to: {file_path}")
  
                              
                              result_text = f"Translation completed successfully.\n\n"
                              result_text += f"Source Language: {translation_result.source_lang}\n"
                              result_text += f"Target Language: {translation_result.target_lang}\n\n"
                              result_text += f"Translated Text:\n{translated_text}\n\n"
                              result_text += f"Result file saved at: {file_path}"
  
                              return TextContent(
                                  type="text",
                                  text=result_text
                              )
                          except Exception as e:
                              logging.error(f"Error downloading translation result: {str(e)}")
                              result_text = f"Translation completed, but failed to download result: {str(e)}\n\n"
                              result_text += f"Source Language: {translation_result.source_lang}\n"
                              result_text += f"Target Language: {translation_result.target_lang}\n\n"
                              result_text += f"Result URL: {translation_result.result}"
  
                              return TextContent(
                                  type="text",
                                  text=result_text
                              )
                      else:
                          
                          result_text = f"Translation completed successfully.\n\n"
                          result_text += f"Source Language: {translation_result.source_lang}\n"
                          result_text += f"Target Language: {translation_result.target_lang}\n\n"
                          result_text += f"No result URL available."
  
                          return TextContent(
                              type="text",
                              text=result_text
                          )
                  elif translation_result.status.lower() == "failed":
                      logging.error(
                          f"Translation failed for Project ID: {project_id}")
                      return TextContent(
                          type="text",
                          text=f"Translation failed"
                      )
  
              except Exception as e:
                  logging.error(f"Error while polling translation status: {str(e)}")
  
              
              time.sleep(polling_interval)
  
          
          if not completed:
              logging.warning(f"Translation not completed within {max_polling_time} seconds for Project ID: {project_id}")
              return TextContent(
                  type="text",
                  text=f"Translation is still in progress. Please check the status later using the project ID: {project_id}"
              )
  
      except Exception as e:
          logging.error(f"Text translation failed: {str(e)}")
          return TextContent(
              type="text",
              text=f"Translation failed: {str(e)}"
          )

• allvoicelab_mcp/server.py:264-287 (registration)

  Registers the 'text_translation' tool with FastMCP, providing name, description with input args and limitations, and binds the handler function text_translation_tool.

  mcp.tool(
      name="text_translation",
      description="""[AllVoiceLab Tool] Translate text from a file to another language.
  
      This tool translates text content from a file to a specified target language. The process runs asynchronously
      with status polling and returns the translated text when complete.
  
      Args:
          file_path: Path to the text file to translate. Only TXT and SRT formats are supported. Maximum file size: 10MB.
          target_lang: Target language code for translation (e.g., 'zh', 'en', 'ja', 'fr', 'de', 'ko'). Required.
          source_lang: Source language code of the original content. Set to 'auto' for automatic language detection. Default is 'auto'.
          output_dir: Output directory for the downloaded result file. Default is user's desktop.
  
      Returns:
          TextContent containing the file path to the translated file or error message.
          If the process takes longer than expected, returns the project ID for later status checking. 
  
      Limitations:
          - Only TXT and SRT formats are supported
          - Maximum file size: 10MB
          - File must exist and be accessible
          - Currently supports a limited set of languages for translation
      """
  )(text_translation_tool)