MCP server providing configuration file tools for AI agents
Server provides 5 configuration parsing tools with complete input schemas and descriptions. All tools are read-only and low-risk. However, descriptions are generic (avg 120 chars, below 194-char baseline), parameter descriptions lack actionable constraints (e.g., no format specs for version strings, no limits on content size), and output schemas are not documented. Error handling returns plain text rather than structured guidance. Tool names are descriptive but lack verb-noun clarity (e.g., 'json_config' vs 'parse_json_config'). No tool annotations (readOnlyHint) despite all being safe operations.
Compare two config files in any format (JSON, YAML, TOML, INI). Shows additions, removals, and changes with path information.
Parse INI and properties configuration files. Read sections and keys, convert between INI and JSON formats.
Read, validate, deep merge, and diff JSON/JSONC configuration files. Supports comments and trailing commas.
Parse TOML configuration files (Cargo.toml, pyproject.toml, etc.). Extract sections, list dependencies, compare versions.
Read, validate, and convert YAML configuration files. Validate against docker-compose, GitHub Actions, or Kubernetes schemas.
Output schemas not documented. Tools return JSON text but LLMs cannot infer field structure for downstream chaining. E.g., json_config 'parse' action returns stringified JSON with no schema declaration.
Parameter descriptions lack actionable constraints. 'content' param has no size limits, encoding hints, or max-length guidance. 'version_a' and 'version_b' in toml_parser have no format spec (semver? pep440?). LLMs cannot validate inputs.
Error handling returns plain text ('Error: ...') instead of structured guidance. No recovery hints. E.g., 'content2 is required for merge action' does not suggest what to do next or how to retry.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 52 | 2026-07-28+ | v2 |
Tool names lack verb-noun clarity. 'json_config', 'yaml_config', 'toml_parser', 'ini_parser' are noun-heavy. Rename to 'parse_json_config', 'parse_yaml_config', 'parse_toml', 'parse_ini' to signal action upfront.
No tool annotations despite all tools being read-only and safe. Missing readOnlyHint annotation would signal to agents that these tools have no side effects and are safe to call speculatively.