MCP server for code collection and documentation
Two tools with basic schemas and descriptions, but significant gaps in parameter documentation and output structure. code_collector accepts union types (string|list[string]) without clear guidance on behavior differences. project_structure_reporter lacks parameter descriptions entirely. Neither tool documents return structure or error recovery paths. Descriptions are present but generic (10-20 words). No tool annotations (readOnlyHint, destructiveHint, idempotentHint) despite both being read-only operations. Error handling returns plain strings without actionable guidance.
Collect code from files into a markdown document
Generate a report of project structure metrics
project_structure_reporter has no parameter descriptions. 'output_filename' and 'ignore_patterns' lack context for LLM selection and usage.
code_collector input_path accepts string|list[string] but does not document behavior difference. Does it recursively collect from directories? Does it treat a list as OR or AND? Ambiguous union types force LLM guessing.
No output schemas documented. Both tools return plain strings ('Code collection complete!...', 'Project structure report generated...') without structured fields. LLMs cannot extract file paths, metrics, or status for downstream chaining.
Error handling returns generic strings ('Error generating report: ...', 'No files found...') without recovery guidance. LLM cannot determine if error is retryable, user-fixable, or fatal.
Inferred effective spec: <=2025-11-25.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 44 | <=2025-11-25 | v2 |
No tool annotations despite both tools being read-only. Missing readOnlyHint would help agents understand these are safe to call without side effects.