Hubshop MCP Server

11개 지역 스토어, 공유되는 WooCommerce 코어, 100개가 넘는 플러그인, 6년치 히스토리입니다. 이 규모의 플랫폼에서 나오는 질문은 대부분 프로그래밍이 아니라 발굴에 가깝습니다. 이 템플릿을 어느 지역이 덮어쓰는지, 이 가격이 어디서 오는지, 이 훅이 바뀌기 전에는 무엇을 했는지 같은 것들입니다. 손으로 답하면 한 시간이 들고, 틀리게 답하면 더 듭니다.

hubshop-mcp은 그 코드 위에 올린 Model Context Protocol 서버입니다. 어시스턴트가 직접 확인할 수 있게 합니다. 도구는 다섯 개입니다. 코드 검색과 조회, WP-CLI 실행, SSH 터널을 통한 데이터베이스 조회, 로컬 환경 제어입니다. 여기에 파일만 읽어서는 알 수 없는 플랫폼의 맥락을 정리한 문서 자료가 함께 있습니다.

핵심은 어디서 도느냐입니다. Claude Code에서도, Codex에서도 돌아가고, Ollama로 로컬에서 도는 모델과도 돌아갑니다. 고객사에 중요한 것은 마지막 선택지입니다. 고객 데이터베이스가 딸린 코드를 외부 업체에 넘길 권한은 저희에게 없고, "학습에 쓰지 않겠다"는 약속은 정책이지 경계가 아닙니다. 로컬 모델에 연결하면 작업은 그 기기 안에서 끝나고 밖으로 나가는 것이 없습니다.

잘못된 답이 손해로 이어지지 않게도 만들었습니다. 모든 도구 결과는 나가기 전에 하나의 필터를 지나고, 데이터베이스 비밀번호는 자격 증명을 읽는 순간 그 필터에 등록됩니다. 그래서 그 도구의 출력에도, 다른 어떤 도구의 출력에도 나타날 수 없습니다. 직접 데이터베이스에 접속할 때는 소유자만 읽을 수 있는 파일에서 비밀번호를 가져오는 보조 스크립트를 씁니다. 응답에도 셸 기록에도 남지 않습니다. SQL은 쓰기를 명시적으로 요청하지 않는 한 읽기 전용이고, 파일과 조회 도구는 클라이언트에 읽기 전용으로 표시됩니다. 테스트 파일 20개가 이 동작을 붙들고 있습니다.

하지 않는 일도 분명히 적어 둡니다. 반대로 읽히기 쉬운 대목이기 때문입니다. 이것은 개인정보 필터가 아닙니다. 알려준 비밀값을 가릴 뿐이고, 읽다가 지나친 개인정보를 가려주지는 않습니다. 실제 데이터베이스에 질의하면 실제 고객 데이터가 나옵니다. 보호는 필터가 아니라 구성에서 나옵니다. 기본은 읽기 전용이고, 민감한 데이터에는 로컬 모델을 씁니다.