MCP server for generating and downloading images using Gigachat API
Server has 3 tools with basic descriptions and minimal parameter documentation. All tools lack proper input schemas with type definitions and parameter descriptions. Naming violates single-responsibility principle (generate_and_save_image combines two concerns). Error handling returns generic strings instead of actionable guidance. No output schemas documented. Parameter descriptions are minimal (e.g., 'Path where to save the image' lacks format/constraint details). Credentials exposed via environment variable but not validated at tool boundary.
Download generated image from Gigachat API and save it to disk.
Generate an image and save it to disk in one step.
Generate an image using Gigachat API based on the provided prompt.
Tool naming violates single-responsibility principle. 'generate_and_save_image' combines image generation and file I/O into one tool. Should split into separate tools so agents can compose them independently.
Input schemas lack proper type definitions and parameter descriptions. Parameters are inferred from function signatures but lack JSON Schema with explicit types, constraints, and descriptions. FastMCP may auto-generate schemas, but they are not visible in source and cannot be verified.
Error handling returns generic error strings ('Error generating image: {str(e)}') instead of actionable recovery guidance. LLM cannot determine if error is retryable, user-fixable, or fatal.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 35 | 2026-07-28+ | v2 |
Output schemas not documented. Tools return plain strings; LLM cannot infer structure or plan downstream operations. No documentation of what fields/format to expect.
Parameter 'output_path' description lacks format constraints. States 'Use absolute path that starts with C:/' but does not validate or document allowed characters, max length, or path traversal protection.