MCP server — convert dashboard images to dashcraft-core React code
Three tools with basic schemas and descriptions, but significant gaps in parameter documentation and output schema clarity. analyze_dashboard and generate_code lack descriptions of what their outputs contain, forcing LLMs to guess at response structure. The 'widgets' parameter in generate_code and generate_project is typed as 'array of objects' with no item schema, LLMs cannot validate or construct valid WidgetAnalysis objects. No error handling guidance. Naming is acceptable (verb_noun pattern), but parameter descriptions are minimal. No tool annotations (readOnlyHint/destructiveHint) despite clear risk profiles.
Analyze a dashboard image using Claude Vision and return widget layout analysis as JSON. Accepts a file path or a base64 data URL.
Generate a complete TSX component from widget analysis data. Returns a ready-to-use @dashcraft/core React component as a string.
Generate a complete Vite + React project as a base64-encoded zip. The zip contains all boilerplate plus the generated @dashcraft/core dashboard component.
Output schemas not documented. analyze_dashboard returns 'widget layout analysis as JSON' but no schema is provided. LLMs cannot plan downstream calls or validate responses.
widgets parameter typed as 'array of objects' with no item schema. WidgetAnalysis structure is undefined, LLMs cannot construct valid input or understand what fields are required.
No tool annotations (readOnlyHint/destructiveHint). generate_project is marked WRITE risk but tool definition lacks destructiveHint annotation. Agents cannot infer side effects from metadata.
No error handling guidance. Tools lack recovery hints (e.g., 'If image format is invalid, try converting to JPEG'). Agents have no path forward on failure.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 46 | 2026-07-28+ | v2 |
Parameter descriptions are minimal. 'format' param in analyze_dashboard says 'Image format hint' but does not explain when to use it or what happens if omitted. 'componentName' and 'projectName' lack guidance on valid characters/length.