Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Maipharm Domae MCP8개 도매상에서 아모잘탄 최저가 검색하고 지오영에서 5개 주문해줘"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
마이팜 도매 통합검색
로컬 설치형 의약품 도매 통합 검색/주문 도구. 8개 도매상의 재고를 한 번에 검색하고, 최저가로 주문할 수 있습니다.
처음 사용하시나요? → 사용 가이드 (그림 포함)를 먼저 읽어보세요.
주요 기능
통합 검색: 8개 도매상 재고를 동시에 검색, 가격 비교
원클릭 주문: 검색 결과에서 바로 주문
긴급주문: 재고 감지 시 자동 주문 (품절약 확보)
가격 모니터링: 등록 제품의 가격/재고 변동 추적
텔레그램 알림: 변동 감지 시 즉시 알림
MCP 연동: Claude Desktop에서 자연어로 검색/주문
Windows 자동시작: PC 부팅 시 백그라운드 실행
지원 도매상
도매상 | 검색 | 주문 | 비고 |
지오영 | O | O | |
복산 | O | O | NicePharm |
인천 | O | O | NicePharm |
티제이팜 | O | O | 2단계 로그인 |
백제 | O | O | JWT 인증 |
HMP | O | X | DWR 프로토콜 |
피코 | O | X | |
새로팜 | O | X |
설치
사전 요구사항
Python 3.10 이상
pip
설치 방법
# 1. 다운로드
git clone https://github.com/maipharm/maipharm-domae-mcp.git
cd maipharm-domae-mcp
# 2. 설치
pip install -e .
# 3. 실행
python -m domae_mcp
# 4. 브라우저에서 접속
# http://localhost:5900프론트엔드 빌드 결과물이 포함되어 있으므로 Node.js는 필요 없습니다.
초기 설정
브라우저에서
http://localhost:5900접속설정 > API 키: 팜스퀘어에서 발급받은 API 키 입력
설정 > 도매 계정: 사용 중인 도매상 ID/PW 입력 → [테스트]로 확인
설정 > 텔레그램 (선택): 봇 토큰 + Chat ID 입력
통합검색에서 의약품 검색 시작
사용법
웹 UI 모드 (기본)
python -m domae_mcp
# http://localhost:5900포트 변경:
python -m domae_mcp --port 5901MCP 모드 (Claude Desktop)
python -m domae_mcp --mcpClaude Desktop 설정 (claude_desktop_config.json):
{
"mcpServers": {
"domae": {
"command": "python",
"args": ["-m", "domae_mcp", "--mcp"]
}
}
}사용 예시:
"아모잘탄 검색해줘"
"지오영에서 아모잘탄 5개 주문해줘"
"모니터링 시작해줘"
Windows 자동시작
# 등록 (PC 부팅 시 자동 실행)
python -m domae_mcp --install-startup
# 해제
python -m domae_mcp --uninstall-startup설정 파일
설정은 ~/.maipharm-domae-mcp/ 에 저장됩니다:
~/.maipharm-domae-mcp/
├── config.json # 도매 계정 (암호화), 텔레그램, API 키
├── .key # 암호화 키 (자동 생성)
└── data/
└── domae.db # SQLite 데이터베이스클라우드 서비스
팜스퀘어 유료회원은 클라우드 서비스를 이용할 수 있습니다:
로컬 (무료) | 베이직 (5만/월) | 프로 (10만/월) | |
모든 기능 | O | O | O |
운영 시간 | PC 켜져있을 때 | 24시간 | 24시간 |
모니터링 간격 | 60분 | 30분 | 5분 |
알림 | 텔레그램 | 텔레그램 + 카카오톡 | 텔레그램 + 카카오톡 |
개발
프로젝트 구조
src/domae_mcp/
├── core/ # 공유 코어
│ ├── crawlers/ # 8개 도매상 크롤러
│ ├── services/ # 검색, 주문, 모니터링, 텔레그램
│ └── models/ # SQLAlchemy 모델
├── local/ # 로컬 모드
│ ├── server.py # FastAPI 웹서버
│ ├── mcp_server.py # MCP stdio 서버
│ ├── config.py # 설정 관리
│ ├── database.py # SQLite
│ ├── scheduler.py # 스케줄러 (60분 최소)
│ └── routers/ # REST API 라우터
└── static/ # React 빌드 결과물프론트엔드 빌드
cd frontend
npm install
npm run build
bash ../scripts/build_frontend.sh크롤러 추가
BaseCrawler를 상속하여 login(), search()를 구현하고 registry.py에 등록합니다.
설계 문서
신규 도매상 요청
설정 페이지의 "신규 도매 요청"에서 새로운 도매상 크롤러 개발을 요청할 수 있습니다.
업데이트
새 버전 출시 시 웹 UI 상단에 알림이 표시됩니다:
cd maipharm-domae-mcp
git pull
pip install -e .라이선스
Business Source License 1.1 (BUSL-1.1)
개인/단일 약국의 로컬 사용: 무료
교육/학습 목적: 무료
호스팅/SaaS/상업적 재배포: 별도 라이선스 필요
2029-03-15 이후 Apache 2.0으로 자동 전환
문의: kjh@maipharm.com
This server cannot be installed
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.