피드로 돌아가기
Dev.toFrontend
원문 읽기
WebMCP 기반 Tool Discovery Registry 및 SDK 구축을 통한 AI Agent 연동 최적화
We built a public registry and SDK for WebMCP tools. Here's why it matters.
AI 요약
Context
WebMCP 표준의 브라우저 내 Tool 실행 기능은 존재하나, 사이트 방문 전 Tool 가용 여부를 확인할 수 있는 Discovery 메커니즘 부재. 이로 인해 AI Agent가 실행 계획을 수립하거나 적절한 사이트를 선택하는 사전 판단 단계에서 병목 발생.
Technical Solution
- DNS TXT 레코드 기반의 도메인 검증 시스템을 포함한 Public HTTP API Registry 설계
- Zod Schema 기반의 Tool 정의를 통해 JSON Schema 자동 생성 및 런타임 Validation 로직 통합
- Component Lifecycle과 연동되는 React Hook 구현을 통한 Tool의 동적 Registration 및 Cleanup 처리
- State Closure 문제 해결을 위해 Schema와 Handler를 분리하는 defineToolContract 구조 채택
- Node isolated context 기반의 CLI 스캔 및 Hash 비교를 통한 증분 업데이트(Incremental Sync) 방식 적용
- 삭제된 Tool의 이력 보존을 위한 Tombstone 처리 전략 도입
실천 포인트
- AI Agent용 API 설계 시 방문 전 Discovery가 가능한 메타데이터 API 제공 검토 - 정적 타입 정의(Zod 등)를 API 스키마와 동기화하여 런타임 에러 방지 및 문서 자동화 구현 - 상태 관리 라이브러리와 연동되는 도구 정의 시 Schema와 Handler의 관심사 분리 적용