show_output_stats
Display statistics for generated images and output directory contents to monitor image generation activity and track results.
Instructions
Show statistics about the output directory and recently generated images.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Implementation Reference
- The core handler function for the 'show_output_stats' tool. It fetches statistics from the file image service, handles errors, formats a markdown summary of the output directory stats (total images, size, recent images), and returns a ToolResult with text content and structured data.def show_output_stats( ctx: Context = None, ) -> ToolResult: """ Show statistics about the output directory and recently generated images. """ logger = logging.getLogger(__name__) try: logger.info("Getting output directory stats") file_service = get_file_image_service() stats = file_service.get_output_stats() if "error" in stats: return ToolResult( content=[ TextContent( type="text", text=f"❌ Error getting output stats: {stats['error']}" ) ], structured_content=stats, ) if stats["total_images"] == 0: summary = ( f"📁 **Output Directory:** `{stats['output_directory']}`\n\n" f"📊 **Stats:** No images found in output directory." ) else: summary = ( f"📁 **Output Directory:** `{stats['output_directory']}`\n\n" f"📊 **Stats:**\n" f"- Total images: {stats['total_images']}\n" f"- Total size: {stats['total_size_mb']} MB\n\n" f"🕒 **Recent Images:**\n" ) for filename in stats.get("recent_images", []): summary += f"- `{filename}`\n" return ToolResult( content=[TextContent(type="text", text=summary)], structured_content=stats ) except Exception as e: logger.error(f"Failed to get output stats: {e}") raise
- Tool schema definition via annotations in the decorator: provides title, description, and read-only hint for the tool.@server.tool( annotations={ "title": "Show output directory stats", "description": "Show statistics about the IMAGE_OUTPUT_DIR and recently generated images", "readOnlyHint": True, }
- nanobanana_mcp_server/core/server.py:38-43 (registration)Top-level registration of the output_stats tool: imports the register function and calls it during _register_tools() to add the tool to the FastMCP server.from ..tools.output_stats import register_output_stats_tool from ..tools.maintenance import register_maintenance_tool register_generate_image_tool(self.server) register_upload_file_tool(self.server) register_output_stats_tool(self.server)
- nanobanana_mcp_server/tools/output_stats.py:12-14 (registration)Wrapper function that registers the show_output_stats tool on the FastMCP server instance using the @server.tool decorator.def register_output_stats_tool(server: FastMCP): """Register output statistics tool with the FastMCP server."""