알라딘 책 API를 Model Context Protocol(MCP) 서버로 제공하는 패키지
Server has 9 tools with complete input schemas and descriptions present. However, descriptions are minimal (10-50 chars), parameter descriptions lack depth, and output schemas are not formally documented. Tool naming follows verb_noun convention (search-, get-) which is good. No tool annotations (readOnlyHint, destructiveHint) despite all tools being read-only. Error handling exists but lacks recovery guidance. Composition is reasonable, tools are single-purpose and chainable via ISBN/categoryId. Major gaps: descriptions too terse for LLM optimization, no output schema documentation, missing parameter format constraints.
베스트셀러 목록 조회 도구
블로거 추천 목록 조회 도구
ISBN으로 책 상세 정보 조회 툴
편집자 추천 목록 조회 도구
신간 목록 조회 도구
중고 매장 보유 정보 조회 도구
책 검색 툴
Tool descriptions are too terse (10-50 chars). LLMs need 50-200 char descriptions explaining WHAT the tool does, WHEN to use it, and what it returns. Current descriptions like '책 검색 툴' and '베스트셀러 목록 조회 도구' lack context for tool selection.
Output schemas are not formally documented. Code shows response structure (title, author, publisher, etc.) but no schema definition visible. LLMs cannot plan downstream calls without knowing return fields.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 48 | 2026-07-28+ | v2 |
카테고리 검색 도구
출판사 검색 도구
No tool annotations despite all tools being read-only. Missing readOnlyHint in tool definitions. This prevents agents from understanding which tools are safe to call without side effects.
Error handling lacks recovery guidance. Code returns 'No search results' or 'Book not found' but does not suggest next steps (e.g., 'Try a broader search term' or 'Check ISBN format'). Errors should guide LLM recovery.
Parameter descriptions lack format constraints. E.g., 'ISBN을 10자리 이상 입력해주세요' states minimum length but does not clarify if hyphens are allowed, if ISBN-10 vs ISBN-13 are both valid, or expected format. Formal constraints prevent LLM hallucination.