나라장터 사용자정보서비스(공공데이터포털 data.go.kr) Open API를 감싼 로컬 MCP 서버
Two tools with strong naming (verb_noun pattern: get_*, check_*) and comprehensive descriptions (250+ chars each). Input schemas are present with proper JSON Schema types and regex validation. However, output schemas are not documented in the visible code, and parameter descriptions lack detail on expected formats, ranges, and error conditions. Tool annotations (READONLY) are correctly applied. The server demonstrates good structure but falls short of A-grade polish due to missing output documentation and limited error guidance.
사업자등록번호에 대해 지정 업종코드·세부품명번호의 보유·유효 여부와 부정당제재를 판정한다. 특정 입찰 자격 충족 여부를 볼 때 쓴다. 업체 전반 프로파일이 필요하면 get_company_profile을 쓴다. 코드→업체 역검색은 지원하지 않으며(사업자번호 입력 필수), 목록이 조회 상한에 잘리면 미보유 판정이 확정이 아닐 수 있다. 한 호출이 facet당 1건 이상, 최소 3건의 API 요청을 소모한다.
사업자등록번호로 한 조달업체의 기본정보·업종·공급물품·부정당제재를 한 번에 조립해 반환한다. 업체 전반을 훑을 때 쓴다. 특정 업종·품목 보유 여부만 판정하려면 check_company_qualification을 쓴다(요청 3건으로 더 가볍다). 사업자번호 입력이 필수이며(업체명→사업자번호 리졸버 없음), 목록은 조회 상한에서 잘릴 수 있다. 한 호출이 facet당 1건 이상, 최소 4건의 API 요청을 소모한다.
Output schemas not documented. Tools return complex nested structures (company profile with basic info, industries, products, sanctions) but no schema is visible in code. LLMs cannot plan downstream operations or extract fields reliably.
Parameter descriptions lack actionable constraints. 'bizno' is described as '10자리(raw bizno)' but no English explanation of what 'raw' means or why it matters. 'industryCodes' and 'productCodes' lack examples of valid formats (e.g., '1234' for industry, '1234567890' for product).
Error handling not documented. Descriptions mention 'API 요청을 소모한다' (consumes API requests) and truncation risks but do not guide LLM on recovery. No documented error codes, retry logic, or fallback strategies.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | C | 63 | 2026-07-28+ | v2 |
Tool descriptions are in Korean only. While appropriate for a Korean-language service, descriptions lack English translations or bilingual clarity, limiting discoverability and usability in multilingual agent environments.
No pagination or result-limiting guidance. 'check_company_qualification' accepts unbounded arrays for industryCodes and productCodes. No documented max array length, and descriptions warn of truncation at 500 items but do not explain how to handle partial results.