Maipharm Domae MCP Server

마이팜 도매 통합검색

로컬 설치형 의약품 도매 통합 검색/주문 도구. 14개 도매상의 재고를 한 번에 검색하고, 최저가로 주문할 수 있습니다.

처음 사용하시나요? → 사용 가이드 (그림 포함)를 먼저 읽어보세요.

주요 기능

• 통합 검색: 14개 도매상 재고를 동시에 검색, 가격 비교
• 원클릭 주문: 검색 결과에서 바로 주문
• 긴급주문: 품절 제품 등록 → 재고 입고 시 자동 주문
• 재고 모니터링: 등록 제품의 가격/재고 변동 추적 + 추이 그래프
• 텔레그램 알림: 변동 감지 시 즉시 알림
• MCP 연동: Claude Desktop에서 자연어로 검색/주문
• Windows 자동시작: PC 부팅 시 백그라운드 실행

지원 도매상 (14개)

설치

Windows (exe)

최신 버전 다운로드 → 실행 → 브라우저 자동 열림

Windows (배치파일)

1. 최신 릴리즈의 zip 다운로드
2. 압축 해제
3. install.bat 더블클릭 (Python 자동 설치)
4. start.bat 더블클릭

Python (개발자)

pip install -e .
python -m domae_mcp
# → http://localhost:5900

초기 설정

1. 브라우저에서 http://localhost:5900 접속
2. 설정 > API 키: 팜스퀘어에서 발급받은 API 키 입력
3. 설정 > 도매 계정: 사용 중인 도매상 ID/PW 입력 → [테스트]로 확인
4. 설정 > 텔레그램 (선택): 봇 토큰 + Chat ID 입력
5. 통합검색에서 의약품 검색 시작

사용법

웹 UI 모드 (기본)

python -m domae_mcp          # http://localhost:5900
python -m domae_mcp --port 5901  # 포트 변경

MCP 모드 (Claude Desktop)

python -m domae_mcp --mcp

Claude Desktop 설정 (claude_desktop_config.json):

{
  "mcpServers": {
    "domae": {
      "command": "python",
      "args": ["-m", "domae_mcp", "--mcp"]
    }
  }
}

Windows 자동시작

python -m domae_mcp --install-startup    # 등록
python -m domae_mcp --uninstall-startup  # 해제

보안

• 도매상 아이디/비밀번호는 Fernet(AES) 암호화되어 저장됩니다
• 암호화 키는 ~/.maipharm-domae-mcp/.key에 자동 생성됩니다
• 평문으로 보관되지 않으며, 검색/주문 실행 시에만 복호화합니다

클라우드 서비스

팜스퀘어 회원은 클라우드 모니터링을 이용할 수 있습니다:

개발

프로젝트 구조

src/domae_mcp/
├── core/               # 공유 코어
│   ├── crawlers/       # 14개 도매상 크롤러
│   ├── services/       # 검색, 주문, 모니터링
│   └── models/         # SQLAlchemy 모델
├── local/              # 로컬 모드
│   ├── server.py       # FastAPI 웹서버 (포트 5900)
│   ├── mcp_server.py   # MCP stdio 서버
│   └── routers/        # REST API
├── cloud/              # 클라우드 워커 (Redis BRPOP)
├── desktop/            # Windows 트레이 앱
└── static/             # React 빌드 결과물

문서

• 아키텍처
• API 명세
• DB 스키마
• 사용 가이드

라이선스

Business Source License 1.1 (BUSL-1.1)

• 개인/단일 약국의 로컬 사용: 무료
• 교육/학습 목적: 무료
• 호스팅/SaaS/상업적 재배포: 별도 라이선스 필요
• 2029-03-15 이후 Apache 2.0으로 자동 전환

문의: kjh@maipharm.com