작업 / 데모

쇼핑몰 관리 데이터를 다루는 MCP 서버

Claude 같은 AI 에이전트가 검증된 도구로 쇼핑몰 데이터를 조회하고 고치게 하는 MCP 서버

역할
설계와 개발
기술
Node.jsTypeScriptMCPClaudezodVitest

상황

AI 에이전트는 실제 업무 데이터를 읽고 고칠 수 있을 때 쓸모가 생깁니다. 대신 입력 검증, 안전한 쓰기, 모든 변경 기록 같은 제한이 함께 있어야 합니다.

만든 것

  • 상품 검색, 상품 상세, 재고 수정, 주문 목록, 주문 상세, 재고 부족 리포트 도구 6개
  • 모든 도구의 입력을 검증하고 재고가 0 아래로 내려가는 수정은 거절
  • 재고를 바꿀 때마다 시각, 사유, 변경 전후 값을 감사 로그로 남김
  • Claude Desktop, Claude Code에서 쓰는 로컬 stdio 연결과 토큰 인증을 거치는 원격 HTTP 연결
  • 데이터 접근을 저장소 인터페이스 하나로 모아 실제 REST API나 DB에 붙일 때는 클래스 하나만 작성

결과

테스트 36개가 도구 동작, 입력 검증, 거절된 요청을 자동으로 확인합니다. 같은 구조로 주문 관리, ERP, CS 시스템을 AI 에이전트와 연결할 수 있습니다.

서버가 제공하는 도구 6개와 입력 스키마
도구 6개마다 쉬운 설명과 타입이 정해진 입력 스키마가 있습니다.
거절된 재고 수정과, 받아들여진 수정의 감사 로그
쓰기는 실행 전에 검사하고 받아들여진 변경은 모두 감사 로그에 남깁니다.
토큰이 있을 때와 없을 때 MCP 엔드포인트로 보낸 HTTP 요청
원격 HTTP 연결은 올바른 토큰이 없으면 요청을 거절합니다.

전체 작업 보기