Domain-Driven Design 기반 MCP 명명법을 통한 리팩토링 Churn 최소화

Context

LLM Agent의 MCP(Model Context Protocol) Tool 명명 시 API 엔드포인트를 그대로 반영하는 Pass-through 방식의 한계 분석. 백엔드 스키마 변경 시 Tool 이름까지 수정해야 함에 따라 프롬프트 및 Eval Fixture 전체를 업데이트해야 하는 높은 의존성 문제 발생.

Technical Solution

• Ubiquitous Language 적용을 통한 도메인 전문가의 용어 기반 명명으로 API 구현 상세와 인터페이스를 분리한 Anti-Corruption Layer 구축
• Bounded Context Prefix 도입을 통해 서로 다른 도메인 간의 Verb 충돌을 방지하고 모델의 Tool 선택 정확도 향상
• Pydantic Discriminated Union을 활용한 리턴 타입 정의로 런타임 스키마 안정성 확보 및 모델의 응답 해석 정밀도 제고
• 단순 CRUD(Create, Update, Delete) 대신 deactivate, close 등 비즈니스 의도가 명확한 도메인 동사를 선택하여 리팩토링 생존력 강화
• 도메인 모델 중심의 명명 체계 구축으로 백엔드 서비스 분리 및 테이블 변경 시에도 Tool 인터페이스를 유지하는 구조 설계