A filesystem text search MCP server that indexes and searches file contents with real-time file watching
Two tools with minimal descriptions (both under 50 chars) and incomplete parameter documentation. search_index accepts only 'keyword' (string, no enum/validation), load_file accepts only 'file_path' (string, no format/constraint). No output schemas documented. No error handling guidance. No tool annotations. Naming is verb-based but descriptions lack WHEN/WHY context required for LLM selection. No parameter descriptions beyond bare names.
Load a file by its path
Search for a string in a file
Tool descriptions are critically short (both <50 chars). 'Search for a string in a file' and 'Load a file by its path' lack WHEN to use, prerequisites, and return value documentation. Baseline: 194 chars average for A+ tools.
No output schemas documented. LLMs cannot plan downstream calls or extract results. search_index likely returns matches (but structure unknown); load_file likely returns file content (but format unknown).
Parameter 'keyword' in search_index has no validation, enum, or format constraint. Accepts free-form strings; no guidance on multi-keyword syntax ('space to separate' is in description, not schema). Should use enum or pattern constraint.
Parameter 'file_path' in load_file has no format, length, or path-traversal constraint documented. No guidance on absolute vs relative paths, symlink handling, or permission checks. Potential security gap.
Inferred effective spec: <=2025-11-25.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 32 | <=2025-11-25 | v2 |
No error handling guidance. What happens if keyword not found? If file doesn't exist? If path is outside allowed directory? LLM receives no recovery hints.