MCP server for executing repository-wide AST-based code migrations and refactoring operations
Critical failures across all dimensions. The single tool 'execute_skill_action' has a minimal description (67 chars, below the 194-char baseline), vague parameter descriptions, and no documented output schema. The implementation is a stub that prints JSON and exits, no actual tool logic is visible. Tool definition appears inferred rather than explicitly registered via MCP protocol. Parameters lack type constraints (no enums, ranges, or validation rules). No error handling, recovery guidance, or security considerations. This server does not meet production-grade standards.
Execute a repository-wide AST-based code migration or refactoring action
Tool definition is inferred, not explicitly registered. No MCP tool registration visible in source code, only a client class and example usage.
No output schema documented. Tool description does not specify what fields are returned (e.g., files_modified_count, ast_transforms_applied, migration_status). LLMs cannot plan downstream actions without knowing response structure.
Parameter descriptions are generic and lack actionable constraints. 'migration_rule' is described as 'The migration rule or refactoring pattern to apply', no guidance on format, examples, or valid patterns. 'target_file_pattern' defaults to '**/*.ts' but description does not explain glob syntax or constraints.
No error handling or recovery guidance. Tool description does not explain failure modes (e.g., invalid migration rule, no matching files, AST parse errors) or what the LLM should do if the tool fails.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 28 | 2026-07-28+ | v2 |
Tool name 'execute_skill_action' is generic and vague. Does not start with a clear action verb (get, create, update, delete, search, list, send). 'execute' + 'skill_action' is ambiguous, LLMs cannot infer intent from the name alone. Should be 'execute_ast_migration' or 'refactor_codebase_with_ast'.