korean-nlp-tools Worker API with MCP support
Korean NLP Tools server has 5 tools with basic schemas and Korean-language descriptions. All tools have input schemas with type definitions and parameter descriptions. However, descriptions are minimal (10-50 chars), lack context on WHEN to use each tool, and do not explain output structure. No output schemas documented. Tool names lack English verb prefixes (tokenize is acceptable, but checkSpelling, normalizeText, extractKeywords, fixSpacing are not verb_noun format). No error handling guidance, no pagination support, no composition hints. All tools are READ_ONLY, which is good, but descriptions do not state this explicitly. Baseline: avg tool description ~25 chars (well below 194-char production baseline); zero output schema documentation.
맞춤법 검사: 자주 틀리는 패턴 기반
키워드 추출: TF 기반 + 한국어 불용어 제거
띄어쓰기 교정
텍스트 정규화
형태소 분석: 한국어 어절을 체언/용언/조사/어미 등으로 분리
Tool descriptions are too short (10-50 chars) and lack context. LLMs cannot determine WHEN to use checkSpelling vs normalizeText vs fixSpacing. Descriptions do not explain output structure or prerequisites.
No output schemas documented. LLMs cannot plan downstream calls or extract results. E.g., tokenize returns what structure? Array of tokens? Objects with POS tags? Unknown.
Tool names do not follow verb_noun convention. checkSpelling, normalizeText, extractKeywords, fixSpacing are gerunds/adjectives, not action verbs. Should be: check_spelling, normalize_text, extract_keywords, fix_spacing.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 33 | 2026-07-28+ | v2 |
No error handling guidance. If tokenize fails on invalid UTF-8 or extractKeywords returns empty results, LLM has no recovery path. Errors should guide next steps.
extractKeywords accepts top_n and min_length options but no pagination or result limit guidance. If text is very large, result set could explode. No documented max results.