A GitHub template repository for Python MCP servers with support for image transfer, image analysis, and multi-server MCP agents
Three tools with basic schemas and descriptions, but significant gaps in parameter documentation and output schema clarity. Tool names follow verb_noun convention (greet, transfer_image, analyze_image), which is good. However, descriptions are minimal (10-30 chars), parameter descriptions lack detail about constraints/formats, and output schemas are not documented. No error handling guidance, no idempotency markers, and no indication of which operations are destructive. The transfer_image tool performs a WRITE operation but lacks confirmation/dry-run patterns. Overall structure is present but falls short of production quality.
Analyze an image using Azure OpenAI vision capabilities
Greet a person by name
Transfer an image from source to destination
Descriptions are too short (10-30 chars). Rubric baseline is 194 chars average; descriptions under 20 chars score 0-20. 'Greet a person by name' and 'Transfer an image from source to destination' lack context for when/why to use these tools.
Output schemas not documented. LLMs cannot plan downstream calls or extract results without knowing what fields are returned. No indication of return types, structure, or pagination.
transfer_image is a destructive WRITE operation but lacks confirmation/dry-run pattern and no error handling guidance. Agents could accidentally overwrite files without recovery options.
Inferred effective spec: <=2025-11-25.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 41 | <=2025-11-25 | v2 |
Parameter descriptions lack format/constraint details. 'Path to the source image file' does not specify: absolute vs relative, supported formats, max file size, or what happens if file doesn't exist.
No tool annotations (readOnlyHint, destructiveHint, idempotentHint). The Risk field in metadata shows transfer_image=WRITE, but this is not exposed in the MCP tool definition where clients can see it.