Read-only MCP filesystem server that respects .gitignore. Exposes: read_file, list_directory, search_files. Blocks: anything matched by .gitignore
Three read-only filesystem tools with basic schemas and minimal descriptions. All tools have input schemas with type definitions, but descriptions are generic (10-50 chars) and lack actionable context. No parameter descriptions provided, LLMs cannot infer what 'path' or 'pattern' mean without explicit guidance. No output schemas documented. Error handling returns plain text, not structured recovery guidance. Missing idempotent/readOnly annotations. No pagination support for search_files despite unbounded results risk.
List files and directories at a path. Respects .gitignore.
Read the contents of a file. Respects .gitignore.
Search for files by name pattern (glob). Respects .gitignore.
Parameter descriptions missing entirely. 'path' and 'pattern' parameters lack descriptions explaining format, constraints, or examples. LLMs cannot infer whether 'path' is absolute/relative, whether it must exist, or what '.gitignore' means in context.
No output schema documented. Callers cannot predict response structure (e.g., does list_directory return 'entries' or 'files'? Is 'type' a string or enum?). LLMs must guess or fail on parsing.
Tool descriptions too short (10-50 chars) and lack context. 'Read the contents of a file. Respects .gitignore.' does not explain when to use this vs list_directory, what happens if file is binary, or whether .gitignore blocking is a feature or limitation.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 45 | 2026-07-28+ | v2 |
search_files returns unbounded results with no pagination. A glob pattern like '*.py' in a large repo could return thousands of matches, exhausting context window. No limit parameter or cursor support.
No tool annotations (readOnlyHint, idempotentHint). While all three tools are read-only and safe to retry, the schema does not declare this. LLMs cannot optimize retry logic or understand safety guarantees.