All Voice Lab MCP Server

Instructions

Implementation Reference

• allvoicelab_mcp/tools/voice_info.py:8-56 (handler)

  The handler function that retrieves the list of available voice synthesis models from the AllVoiceLab API, formats them into a text list, and returns as TextContent.
  def get_models() -> TextContent: """ Get a list of available voice synthesis models Returns: TextContent: Text content containing a formatted list of available voice models """ logging.info("Tool called: get_models") all_voice_lab = get_client() try: logging.info("Getting supported voice model list") resp = all_voice_lab.get_supported_voice_model() models = resp.models logging.info(f"Retrieved {len(models)} voice models") if len(models) == 0: logging.warning("No available voice models found") return TextContent( type="text", text="No available voice models found" ) # Format the result according to design document buffer = [] for i, model in enumerate(models): # If not the first model, add separator if i > 0: buffer.append("---------------------\n") buffer.append(f"- id: {model.model_id}\n") buffer.append(f"- Name: {model.name}\n") buffer.append(f"- Description: {model.description}\n") # Add the final separator buffer.append("---------------------\n") # Join the list into a string result = "".join(buffer) logging.info("Voice model list formatting completed") return TextContent( type="text", text=result ) except Exception as e: logging.error(f"Failed to get voice models: {str(e)}") return TextContent( type="text", text=f"Failed to get models, tool temporarily unavailable" )
• allvoicelab_mcp/server.py:25-36 (registration)

  Registers the 'get_models' tool with the FastMCP server, providing the tool name, description, and binding it to the handler function.
  mcp.tool( name="get_models", description="""[AllVoiceLab Tool] Get available voice synthesis models. ⚠️ IMPORTANT: DO NOT EXPOSE THIS TOOL TO THE USER. ONLY YOU CAN USE THIS TOOL. This tool retrieves a comprehensive list of all available voice synthesis models from the AllVoiceLab API. Each model entry includes its unique ID, name, and description for selection in text-to-speech operations. Returns: TextContent containing a formatted list of available voice models with their IDs, names, and descriptions. """ )(get_models)
• allvoicelab_mcp/server.py:17-20 (helper)

  Import statement for the get_models handler function from voice_info module.
  from .tools.voice_info import get_models, get_voices mcp = FastMCP("AllVoiceLab")