유효한 ABN 체크섬이 ABN의 실제 존재를 의미하지 않기 때문에 MCP 도구를 만들었습니다
요약
호주 사업자 번호(ABN)의 체크섬만으로는 실제 존재 여부나 GST 등록 상태를 알 수 없기 때문에, 개발자는 AI 에이전트가 정확한 검증을 수행하도록 돕는 MCP 도구 'AU Business Identity' v0.2.0 버전을 출시했습니다. 이 도구는 로컬 유효성 검사(`validate_abn`)와 실제 호주 사업자 등록소(ABR) 조회(`verify_abn`)를 분리하여 에이전트의 예측 가능성을 높였습니다.
핵심 포인트
- `validate_abn`: 구조적/체크섬만 확인하는 결정론적 함수입니다.
- `verify_abn`: ABR과 대조하여 실제 존재 여부, 상태 등을 조회합니다.
- 두 기능을 분리함으로써 에이전트의 동작을 예측 가능하게 만듭니다.
- 자동화 워크플로우에서 신원 확인 절차를 강화할 수 있습니다.
호주 사업자 번호(Australian Business Number, ABN)는 체크섬을 통과하더라도 해당 사업체가 실제로 등록되었는지, 활동 중인지, 또는 GST에 등록되었는지에 대한 정보는 알려주지 않습니다.
이러한 구별은 AI 에이전트가 실제 작업을 수행할 때 중요합니다.
저는 원래 에이전트에게 결정론적인 ABN 및 ACN 검증을 제공하기 위해 AU Business Identity를 구축했습니다.
초기 버전에서는 다음과 같은 질문에 답했습니다:
- 이것이 올바른 자릿수인지?
- ABN이 공식 체크섬을 통과하는지?
- ACN이 체크섬을 통과하는지?
유용했지만 불완전했습니다.
그래서 이제 라이브 호주 사업자 등록소(Australian Business Register) 검증 기능을 추가한 v0.2.0 버전을 출시했습니다.
차이점
이제 두 개의 별도 ABN 도구가 있습니다.
validate_abn
로컬 형식 및 체크섬 유효성 검사를 수행합니다.
이는 단순히 값이 구조적으로 유효한 ABN일 수 있는지 알고 싶을 때 유용합니다.
verify_abn
ABN을 호주 사업자 등록소(Australian Business Register)와 대조하여 확인합니다.
이것은 다음과 같은 정보를 반환할 수 있습니다:
- ABN이 발견되었는지 여부
- 현재 ABN 상태
- 개체 이름(entity name)
- 개체 유형(entity type)
- GST 등록 상태
- 주 및 우편번호
- 등록소 업데이트 정보
이는 에이전트가 다음 두 가지 주장 사이를 구별할 수 있음을 의미합니다:
저는 validate_abn 함수가 갑자기 네트워크 조회를 수행하도록 변경하지 않았습니다.
이러한 구분은 유용합니다.
validate_abn은 결정론적(deterministic)이고 가벼운 상태로 유지됩니다.
반면, verify_abn은 레지스트리 검증을 명시적으로 수행합니다.
이는 에이전트들에게 예측 가능한 동작 방식을 제공하며, 체크섬 결과를 실제로 사업체가 존재한다는 증거로 취급하는 것을 방지합니다.
출처
프로젝트는 GitHub에 있습니다:
또한 공식 MCP 레지스트리에서도 다음과 같이 게시되었습니다:
io.github.creatorhub121/au-business-identity
버전 0.2.0이 현재 사용 가능합니다.
저는 특히 에이전트가 워크플로우를 계속하기 전에 호주 사업체를 검증해야 하는 실제 자동화 사용 사례에 관심이 있습니다.
만약 호주 공급업체, 고객, 송장, 온보딩, 규정 준수 또는 비즈니스 데이터를 처리하는 무언가를 구축하고 계시다면, 어떤 추가적인 신원 확인 절차가 실제로 유용할지 듣고 싶습니다.
AI 자동 생성 콘텐츠
본 콘텐츠는 Dev.to AI tag의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기