Skip to content

edward-kim-dev/kr-pc-deals-mcp

Repository files navigation

kr-pc-deals-mcp

AI한테 "100만원으로 게이밍 PC 짜줘"라고 하면, 다나와/컴퓨존 최저가를 비교해서 진짜 견적을 짜줍니다.

한국 PC 부품 가격비교 및 조립 견적 MCP 서버입니다. Claude, ChatGPT, Cursor 등 MCP를 지원하는 모든 AI 앱에서 사용할 수 있습니다.

데모

"영상 편집용 조립 PC 견적" 요청 예시 (Claude Desktop, 5배속)

데모

견적 구성 합계 및 의견 다나와 상품 링크 컴퓨존 상품 링크 추가 질문 및 의견

주요 기능

  • 부품 검색 — 다나와 + 컴퓨존 통합 검색
  • 가격 비교 — 동일 제품의 크로스사이트 최저가 비교
  • 가격 이력 — 다나와 가격 변동 추적 (1/3/6/12개월)
  • 빌드 견적 — 부품을 하나씩 추가하며 견적 구성, 합계 자동 계산
  • 호환성 체크 — 다나와 가상견적 API 기반 CPU-메인보드-RAM 호환성 자동 검증
  • 프록시 지원 — 차단 시 Zyte 프록시 자동 폴백

빠른 시작

Claude Desktop

SettingsDeveloperEdit Config에서 claude_desktop_config.json을 열고 아래를 추가:

{
  "mcpServers": {
    "kr-pc-deals-mcp": {
      "command": "npx",
      "args": ["-y", "kr-pc-deals-mcp"]
    }
  }
}

Claude Code

claude mcp add kr-pc-deals-mcp npx -- -y kr-pc-deals-mcp

Cursor

프로젝트 루트에 .cursor/mcp.json 파일 생성:

{
  "mcpServers": {
    "kr-pc-deals-mcp": {
      "command": "npx",
      "args": ["-y", "kr-pc-deals-mcp"]
    }
  }
}

직접 설치

요구사항

  • Node.js 20 이상
  • npm 또는 yarn

설치

git clone https://github.com/yourname/kr-pc-deals-mcp.git
cd kr-pc-deals-mcp
npm install

빌드

npm run build

실행

# 개발 모드 (TypeScript 직접 실행)
npm run dev

# 프로덕션 모드
npm run build
npm start

테스트

npm test

환경 변수

.env.example.env로 복사하여 설정합니다.

cp .env.example .env
변수 설명 기본값
ZYTE_API_KEY Zyte 프록시 API 키 (차단 시 자동 우회) 미설정 (직접 요청만)

Zyte 없이도 정상 동작합니다. 다나와/컴퓨존에서 반복 요청으로 차단될 때만 필요합니다. https://www.zyte.com 에서 무료 체험 API 키를 발급받을 수 있습니다.


사용 예시

Claude나 Cursor에서 아래처럼 자연어로 질문하면 됩니다:

부품 검색

"RTX 4070 SUPER 검색해줘" "i7-14700K 다나와에서 찾아봐"

가격 비교

"RTX 4070 SUPER 다나와랑 컴퓨존 가격 비교해줘" "DDR5 32GB 최저가 찾아줘"

PC 견적

"100만원으로 게이밍 PC 견적 짜줘" "200만원 영상편집용 PC 추천해줘"

호환성 체크

"이 견적 호환성 체크해줘" "지금 빌드에 추가한 부품들 호환되는지 확인해줘"

가격 이력

"이 제품 최근 3개월 가격 변동 보여줘"


MCP 도구 목록

검색

도구 설명
search_parts PC 부품 키워드 검색 (다나와/컴퓨존/전체)
get_product_detail 상품 상세 정보 (스펙, 판매처별 가격)
get_price_history 가격 변동 이력 (1/3/6/12개월)

가격 비교

도구 설명
compare_prices 다나와↔컴퓨존 동일 제품 가격 비교
find_lowest_price 통합 최저가 검색
list_by_category 카테고리별 인기/최저가 목록

빌드 (견적)

도구 설명
build_add 빌드에 부품 추가 (2개 이상 시 호환성 자동 체크)
build_remove 빌드에서 부품 제거
build_status 현재 빌드 상태 조회
build_check_compatibility 다나와 API 기반 부품 간 호환성 체크

시스템

도구 설명
proxy_status 프록시/차단 상태 확인

지원 카테고리

CPU, 그래픽카드, 메인보드, RAM, SSD, HDD, 파워서플라이, 케이스, CPU 쿨러, 모니터


아키텍처

사용자 (Claude/Cursor/ChatGPT)
  ↓ MCP Protocol (stdio)
kr-pc-deals-mcp Server
  ├── 다나와 Provider (검색, 상세, 가격이력, 가상견적, 호환성 API)
  ├── 컴퓨존 Provider (검색, 상세)
  ├── 가격 비교 Service (크로스사이트 매칭)
  └── Zyte Proxy (차단 시 자동 폴백)

차단 방지 메커니즘

단계 설명
사이트별 동시성 제어 다나와 최대 3건/500ms, 컴퓨존 최대 2건/1,000ms
인메모리 캐시 동일 검색 결과 재사용
지수 백오프 차단 시 30초 → 60초 → 120초 → 최대 5분
Zyte 자동 폴백 3회 연속 실패 시 프록시 모드 전환

개발

# TypeScript 타입 체크
npx tsc --noEmit

# 테스트
npm test

# 테스트 (watch 모드)
npm run test:watch

# 빌드
npm run build

면책 조항

이 소프트웨어는 개인적, 비상업적 용도로만 사용하십시오.

  • 이 도구는 공개된 웹페이지의 가격 정보를 수집합니다.
  • 다나와 및 컴퓨존의 이용약관을 준수할 책임은 사용자 본인에게 있습니다.
  • 과도한 요청으로 서버에 부하를 주는 행위는 금지합니다.
  • 수집한 데이터를 상업적으로 활용하거나 재배포하는 행위는 금지합니다.
  • 이 소프트웨어 사용으로 인한 법적 책임은 개발자가 지지 않습니다.

라이선스

MIT


참고

이 프로젝트는 daiso-mcp의 아키텍처 패턴을 참고하여 개발되었습니다.

관련 리소스

About

한국 PC 부품(다나와/컴퓨존) 가격비교 MCP 서버

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors