MCP server for Claude Code that prevents context rot — by ninodinoo
Two tools with complete Zod schemas and descriptions, but significant quality gaps. Tool names lack action verbs (memory, checkpoint instead of read_memory/write_memory/set_checkpoint). Descriptions are present but generic, memory's description is 180 chars (within baseline 194 avg) but conflates multiple operations (read/write/append/delete) into one tool, violating single-responsibility. Parameter descriptions exist but lack actionable constraints (e.g., 'topic' has no format guidance; 'mode' enum is present but only relevant conditionally). No output schema documentation. Error handling returns plain text without recovery guidance. German descriptions reduce LLM clarity in English-dominant environments.
Speichert den aktuellen Arbeitsstand unter 'current-task'. Rufe dies nach jedem bedeutenden Schritt auf. Wird automatisch bei der nächsten Session geladen.
Liest, schreibt, hängt an oder löscht Memory-Einträge. Ohne topic: Übersicht aller Topics. Mit topic ohne content: Eintrag lesen. Mit topic + content: Eintrag schreiben/anhängen/löschen.
Tool names lack action verbs. 'memory' and 'checkpoint' do not convey what action occurs. Should be 'read_memory', 'write_memory', 'append_memory', 'delete_memory', 'set_checkpoint' to match LLM verb-noun parsing.
Single 'memory' tool combines four operations (read, write, append, delete). Violates single-responsibility principle. LLM must reason about mode parameter to determine intent. Should split into separate tools: read_memory, write_memory, append_memory, delete_memory.
Parameter 'topic' lacks format constraints. Description says 'e.g. decisions, architecture, entities/auth' but does not specify allowed characters, max length, or path depth. LLM cannot validate input before calling.
No output schema documented. Tool responses return plain text in content array, but LLM has no formal schema to parse structured fields. Cannot chain results to downstream tools.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 56 | 2026-07-28+ | v2 |
Error responses are plain text without recovery guidance. 'Memory not found' does not tell LLM whether to retry, call a discovery tool, or ask user. Violates recovery-guide pattern.