MCP server for Engineering Assistant - provides sandboxed file system access for code analysis
Four read-only tools with complete input schemas and descriptions. Naming follows verb_noun convention (list_, read_, search_, get_). Descriptions are adequate (100-150 chars) but lack LLM-optimized guidance on when to use each tool vs. alternatives. Parameters are typed and described, but lack constraints (enums, ranges, patterns). Output schemas are not documented in the source code provided. Error handling and recovery guidance are absent. No tool annotations (readOnlyHint, etc.) despite all being read-only operations.
Get a high-level overview of the repository structure, file types, and statistics
List files and directories in a repository with optional filtering and depth control
Read the contents of a file with size limits and encoding support
Search for files and content matching a pattern with regex and glob support
Output schemas not documented. LLMs cannot plan downstream operations or extract required fields without knowing what each tool returns.
No tool annotations despite all tools being read-only. readOnlyHint should be applied to all four tools to signal safety to agents.
Parameter constraints missing. 'max_depth' and 'max_bytes' lack min/max bounds; 'pattern' lacks format guidance; 'encoding' enum is present but other params lack similar constraints.
Descriptions lack LLM-optimized guidance on when to use each tool. 'search_files' vs 'list_files' distinction is unclear; no hints on dependencies or prerequisites.
Inferred effective spec: <=2025-11-25.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 55 | <=2025-11-25 | v2 |
No error handling or recovery guidance documented. If a file is too large, encoding fails, or a pattern is invalid, LLMs have no guidance on what to do next.