A MCP server implementation to support typescript related operations.
Single tool with adequate schema and parameter descriptions, but lacks critical production-grade patterns. Tool name is clear (get_type_definition_at_position), and input schema is properly defined with Zod validation. However, output schema is not documented, the response structure is inferred from code but not formally declared. Error handling is minimal (throws generic errors without recovery guidance). No tool annotations (readOnlyHint, idempotentHint). Description is 108 chars, within acceptable range but could be more actionable. Parameters have descriptions but lack format constraints (e.g., line/column must be positive integers). No pagination, batching, or composition patterns evident.
Get type typescript type definitions for the symbol at the given line and column
Output schema not documented. Response structure (typeInfo, symbolDetails, typeDetails fields) is inferred from code but not formally declared in tool registration. LLMs cannot plan downstream operations without knowing return fields.
Error handling lacks recovery guidance. Errors like 'tsconfig file was not found' and 'No symbol found at this position' are returned as plain text without actionable next steps. LLM cannot self-correct or suggest alternatives.
Numeric parameters (line, column) lack constraints. No minimum/maximum bounds specified. LLMs may pass negative or absurdly large values. Description should state 'line: 1-based positive integer' and 'column: 0-based non-negative integer'.
No tool annotations. Tool is read-only (does not modify files) but lacks readOnlyHint annotation. This prevents agents from understanding safety guarantees and optimizing execution plans.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 50 | 2026-07-28+ | v2 |
Tool description does not explain when to use it or what it returns. Current: 'Get type typescript type definitions for the symbol at the given line and column'. Better: 'Retrieve the TypeScript type definition for a symbol at a specific location. Returns type string, symbol name, and detailed type information. Use this to understand variable types, function signatures, and inferred types during code analysis.'