MCP server wrapper for git-quick-stats that exposes tools to run git-quick-stats in non-interactive mode from MCP clients.
Two tools with basic schemas and descriptions, but significant gaps in parameter documentation and output schema clarity. Tool names follow verb_noun convention (list_, run_) which is good. However, the run_git_quick_stats tool has 14 parameters with minimal descriptions, most lack guidance on format, constraints, or when to use them. No output schema documented for either tool. Error handling is absent from descriptions. The server exposes git-quick-stats functionality but does not optimize the interface for LLM reasoning.
List supported git-quick-stats MCP options and requirements.
Run one git-quick-stats non-interactive option. For options that ask for prompts in the original script, pass the matching env-backed value (`author`, `branch`, `tag`) or use `stdin_input`.
run_git_quick_stats has 14 parameters with minimal or missing descriptions. Parameters like 'merge_view', 'ignore_authors', 'sort_by', 'pathspec' lack guidance on valid values, format, or when to use them. LLMs cannot infer constraints from names alone.
No output schema documented for either tool. list_git_quick_stats_options returns a dict but structure is not specified. run_git_quick_stats output format is unknown, is it JSON, plain text, structured object? LLMs need documented return types to plan downstream actions.
Parameter descriptions lack format/constraint guidance. 'since' and 'until' accept date strings but no format specified (ISO 8601? YYYY-MM-DD?). 'limit' and 'days' are integers but no min/max bounds. 'option' is required but no enum of valid options provided in schema.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 56 | 2026-07-28+ | v2 |
No error handling guidance in tool descriptions. What happens if repo_path is invalid? If option is unsupported? If timeout_seconds is exceeded? Descriptions do not tell LLMs what to do on failure.
STDIO transport only. Server is not remotely accessible and cannot be used by hosted MCP clients. This is a hard architectural limitation.