TypeScript MCP Server with various tools including greeting, calculator, time, weather, geocode, and image generation
Server has 6 tools with proper schemas (Zod definitions visible) and descriptions in Korean. Naming follows verb patterns (greeting, calculator, get_time, generate_image, geocode, get_weather). Schemas are complete with types and descriptions for all parameters. However, descriptions are in Korean, limiting accessibility for English-speaking LLMs. Parameter descriptions are present but minimal (typically 10-50 chars). Error handling is present but basic. Output schemas are documented only through return type annotations (text/image content arrays). No tool annotations (readOnlyHint, destructiveHint, idempotentHint) present. Overall definitions meet baseline functionality but lack production-grade optimization for LLM selection and multi-step reasoning.
예시 도구: 계산기
이미지 생성 도구
Geocode MCP 도구: Nominatim OpenStreetMap API를 사용한 지오코딩
TIME MCP 도구: 타임존별 현재 시간 조회
날씨 정보 도구: Open-Meteo API 사용
인사하기
Descriptions in Korean limit accessibility for English-speaking LLMs and reduce tool discoverability in multi-lingual agent environments
Missing tool annotations (readOnlyHint, destructiveHint, idempotentHint) prevents agents from reasoning about side effects and retry safety
Output schemas documented only implicitly via return type annotations; no explicit schema for response fields (e.g., weather data structure)
generate_image tool exposes Hugging Face token requirement in parameter description; should be validated server-side via configSchema
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-22 | D | 52 | 2026-07-28+ | v2 |
| 2026-03-09 | F | 33 | - | v1 |
Geocode tool lacks pagination documentation despite accepting 'limit' parameter; no mention of total result count or cursor for handling large result sets
Error handling is generic; missing recovery guidance (e.g., 'try search_users() first' pattern) for dependent tools