A local AI personal assistant framework with MCP tool server, voice I/O, semantic memory, and master context system for managing contextual tools.
Critical gaps across all dimensions. Tool definitions exist but lack rigor. Schemas are present but minimal (no parameter descriptions, no output schemas documented). Descriptions are present but generic and under-optimized for LLM selection. No error handling guidance, no parameter validation rules, no composition support. Tools appear inferred from setup.py rather than explicitly registered with full MCP metadata. This server would not pass code review.
Activates a master context tool, loading its contextual sub-tools into memory.
Deactivates the currently active master context tool, returning to global tools only.
Checks which master context tool is currently active in the system.
Lists all available master context tools that can be activated.
Capture and analyze the current state of the user's screen.
No output schemas documented for any tool. LLMs cannot plan downstream calls or extract required fields. Violates pattern:tool and pattern:response-shaper.
Parameter descriptions missing or absent. 'master_name' in activate_master has no description explaining what constitutes a valid master name, format, or how to discover available names. Violates pattern:tool-description.
Tool descriptions are generic and under 50 characters. 'Activates a master context tool...' does not explain WHEN to use this vs alternatives, what 'master context' means, or what happens to existing state. Baseline: A+ tools average 194 chars with clear WHAT/WHEN/WHY.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 40 | 2026-07-28+ | v2 |
No error handling guidance. If activate_master fails (master not found, already active, permission denied), the tool provides no recovery path. Violates pattern:recovery-guide.
Tool definitions appear inferred from setup.py rather than explicitly registered in MCP server code. No visible tool registration with full schemas, descriptions, and metadata in server_mcp.py.