From 007597245e46fe981e40e7131d639774ca24d4e6 Mon Sep 17 00:00:00 2001 From: Thomas Bale Date: Tue, 2 Jun 2026 01:08:42 +0100 Subject: [PATCH] docs(server): disclose play_audio's file-folder walking behavior in tool description play_audio relies on process_input_file(), which automatically searches the parent directory for similar filenames when the exact path is not found. This behavior was not mentioned in the tool description, so MCP clients had no way to know up front that the server would look beyond the literal path they provided. Disclose the behavior in the tool description so clients/users can make an informed trust decision. Fixes #78. Co-authored-by: Zippy AI Co-Authored-By: Claude Opus 4.7 --- minimax_mcp/server.py | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/minimax_mcp/server.py b/minimax_mcp/server.py index ce74c5e..702c474 100644 --- a/minimax_mcp/server.py +++ b/minimax_mcp/server.py @@ -274,6 +274,11 @@ def voice_clone( @mcp.tool( description="""Play an audio file. Supports WAV and MP3 formats. Not supports video. + Note: If the exact file is not found at the given path, the server will + search the parent directory for files with similar names and suggest them + in the error message. This is for ergonomic file lookup only — no files + outside the parent directory are read. + Args: input_file_path (str): The path to the audio file to play. is_url (bool, optional): Whether the audio file is a URL.