RAG on local files with MCP - enables querying local documents (PDF, CSV, DOCX, MD, TXT) through MCP tools and prompts
Single tool 'minima-query' has a basic schema and description but lacks depth. Schema is present (Query model with 'text' parameter), but description is generic (47 chars, below 50-200 char baseline for LLM optimization). Parameter 'text' has a description but is vague ('context to find', does not explain what 'context' means, expected format, or examples). No output schema documented, LLMs cannot predict what fields to expect from the response. Error handling exists (McpError for INVALID_PARAMS, INTERNAL_ERROR) but lacks recovery guidance. Tool name 'minima-query' does not follow verb_noun convention (should be 'search_files' or 'query_documents'). Prompts feature is declared but the prompt 'minima-query' duplicates the tool name and has minimal documentation.
Find a context in local files (PDF, CSV, DOCX, MD, TXT)
Tool name 'minima-query' does not follow verb_noun convention. Should be 'search_files', 'query_documents', or 'find_context' to clearly signal the action to LLMs.
Parameter 'text' description is vague ('context to find'). Does not explain what 'context' means, expected format (free text? keywords? phrases?), file types searched, or result structure. LLMs cannot infer intent.
No output schema documented. Tool returns TextContent with unstructured 'text' field. LLMs cannot predict response structure, cannot chain to downstream tools, and cannot extract file paths, line numbers, or relevance scores.
Error messages lack recovery guidance. 'Context is required' and generic INTERNAL_ERROR do not tell LLM what to do next. Should suggest 'Try rephrasing your search' or 'Check that files are indexed'.
Inferred effective spec: <=2025-11-25.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 44 | <=2025-11-25 | v2 |
Tool description (47 chars) is below LLM-optimized baseline (50-200 chars). Does not explain when to use this tool vs alternatives, what file types are supported, or what 'context' means in this domain.