모든 프로젝트
Selected Work — 2026 · Open Source Contribution
DAISO
MCP
오픈소스 기여
DAISO MCP 오픈소스 기여
GITHUBRepository
GITHUBPull Request #41
GITHUBIssue #40
Timeline
2026.05
Category
Open Source Contribution
— Overview

이 프로젝트는.

다이소 매장 재고 조회가 403으로 깨진 문제를 추적하고, 변경된 다이소몰 인증·재고 조회 흐름으로 MCP 도구를 전환한 오픈소스 기여

— Challenge

결정의 흐름.

“무엇을 만들었나” 보다 “왜 그렇게 결정했나” 를 남깁니다.

01·BREAKAGE

매장 재고 조회 403 문제를 재현하고 원인을 추적

기존 다이소 매장 재고 조회 endpoint가 403 Unauthorized를 반환하면서 MCP의 핵심 기능이 깨진 상태였습니다.

  • 기존 endpoint 403 재현
  • 온라인 재고와 매장 재고 흐름 분리 확인
  • 문제 보고 issue #40 정리
  • 수정 범위와 기존 기능 영향 범위 분리
02·REVERSE ENGINEERING

변경된 다이소몰 프론트엔드 흐름 분석

다이소몰 프론트엔드 요청을 따라가며 실제 매장 재고 조회에 필요한 API 흐름을 다시 확인했습니다.

  • 매장 조회: POST /ms/msg/selStr
  • 인증 bootstrap: GET /auth/request
  • 재고 조회: POST /pd/pdh/selStrPkupStck
  • Authorization + X-DM-UID 헤더 필요 조건 확인
03·MCP INTEGRATION

MCP 재고 조회 도구를 신규 인증 흐름으로 전환

확인한 신규 API 흐름을 MCP 도구 내부에 반영해 매장별 재고 조회 기능을 다시 사용할 수 있는 구조로 수정했습니다.

  • 신규 인증 요청 helper 추가
  • 매장 코드 기반 batched stock 조회로 전환
  • non-pickup store 포함 per-store quantity 처리
  • 기존 online stock 흐름과 충돌하지 않게 분리
04·VALIDATION

실제 매장 코드와 테스트로 동작 검증

실제 매장 코드로 신규 endpoint가 수량을 반환하는지 확인하고, PR 단위 테스트로 변경 범위를 검증했습니다.

  • 실제 store code 기반 응답 확인
  • per-store quantity 반환 확인
  • unit test 통과 확인
  • coverage 기준에서 추가 보강 필요 지점 파악
— Stack

사용한 도구들.

Tools & Technologies
MCPTypeScriptNode.jsDaisomall APIHTTP Auth FlowInventory LookupAPI Reverse EngineeringUnit Test
— Quote
“깨진 API를 고치는 일은 코드를 바꾸기 전에, 서비스가 실제로 어떻게 흐르는지 다시 읽는 일이었습니다.”
— 프로젝트 회고