MCP server for Amiga cross-development, providing build, deployment, debugging, and serial communication tools for AmigaOS development
7 tools with HTTP transport and explicit schema definitions. Most tools have descriptions and parameter schemas, but several critical gaps exist: (1) No tool annotations (readOnlyHint, destructiveHint, idempotentHint) despite clear categorization of WRITE vs READ_ONLY risk levels; (2) Parameter descriptions exist but are often terse (under 40 chars) and lack actionable guidance; (3) No documented output schemas, responses are not formally specified; (4) No error handling documentation or recovery guidance; (5) Tool names follow verb_noun pattern but some are domain-specific (amiga_*) which is appropriate but narrows discoverability. The amiga_watch_logs tool has streaming semantics (returns after duration_ms) but this is not reflected in output schema. The amiga_inspect_memory tool lacks max value constraints on the 'size' parameter despite mentioning max 4096.
Build an Amiga project using Docker cross-compiler. Omit project to build all.
Clean build artifacts for a project.
Connect to the Amiga emulator. Uses PTY mode by default (creates /tmp/amiga-serial for FS-UAE). Set mode='tcp' for WinUAE TCP serial.
Disconnect from Amiga serial port.
Request a memory dump from the Amiga. Streams progress via notifications.
Get recent log messages from buffer.
Stream Amiga logs in real-time via MCP notifications. Returns after duration_ms (default 30s). Logs are pushed as they arrive.
No tool annotations (readOnlyHint, destructiveHint, idempotentHint) despite explicit WRITE vs READ_ONLY risk classification
No documented output/return schemas for any tool. LLMs cannot plan downstream calls or extract fields without knowing response structure.
No error handling documentation or recovery guidance. What happens on connection failure, invalid address, or timeout? What should the LLM do?
Inferred effective spec: <=2025-11-25.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-22 | C | 63 | <=2025-11-25 | v2 |
| 2026-03-09 | F | 41 | - | v1 |
Parameter 'size' in amiga_inspect_memory mentions max 4096 in description but lacks explicit maximum constraint in schema
amiga_disconnect has minimal description (single word 'Disconnect from Amiga serial port.'), under 50 chars, no context on when to use or what it returns
amiga_watch_logs description mentions 'MCP notifications' and 'Returns after duration_ms' but does not document what fields are in each log notification or what the tool returns (empty result? summary?)
Parameter descriptions often terse and lack actionable guidance. E.g., 'Subpath to build' (16 chars) does not explain relative to what directory, whether absolute paths work, or example format.