mcp_test — 시약 재고 MCP 서버 (chem-inventory)

MCP(Model Context Protocol) 표준 규격을 지킨 서버. SQLite에 mock 시약 데이터를 담고 검색·상세조회·재고차감·사용이력 기능을 제공한다. 통신 검증용 도구(ping/echo)도 유지.

구성

파일	역할
server.py	MCP 서버. 통신 검증 도구 + 시약 재고 도구 9종, Resource 2종, Prompt 2종
db.py	SQLite 스키마 생성 + mock 데이터 시딩(멱등) + 조회/차감 함수
test_client.py	테스트 클라이언트. 핸드셰이크부터 DB 쓰기·에러 처리까지 14개 항목 검증
chem.db	SQLite 데이터 파일 (첫 실행 시 자동 생성·시딩, 삭제하면 초기화됨)

기능 (Tools)

도구	설명
search_chemicals(keyword)	국문명/영문명/CAS 번호 부분 일치 검색
get_chemical(cas_no)	GHS 유해성, 보관 위치, 재고 상세 조회
low_stock_report()	발주 기준 미달 시약 목록 (부족률 순)
use_chemical(cas_no, amount, used_by)	재고 차감 + 사용 이력 기록. 재고 부족 시 에러
usage_history(cas_no?, limit)	최근 사용 이력 조회
ping / echo / add / get_server_info	통신 검증용

Resources: chem://inventory (전체 재고 현황판), info://server Prompts: safety_review(cas_no) (안전 취급 검토 요청), greeting

Mock 데이터: 아세톤, 황산, 수산화나트륨, 메탄올, 염산, 톨루엔, 과산화수소 7종 (수산화나트륨·메탄올은 의도적으로 재고 부족 상태 → low_stock_report 테스트용)

요구사항

python -m pip install mcp --trusted-host pypi.org --trusted-host files.pythonhosted.org

주의: pip 단독 실행 시 다른 사용자 계정의 Python에 설치될 수 있으므로 반드시 python -m pip 사용.

실행

1. stdio 전송 (로컬, Claude Desktop 등)

python test_client.py          # server.py를 서브프로세스로 띄워 자동 테스트

2. Streamable HTTP 전송 (서버 간 네트워크 통신 테스트)

# 터미널 1 — 서버
python server.py --http --port 8765          # 로컬만: 127.0.0.1
python server.py --http --host 0.0.0.0       # 다른 서버에서 접속 허용

# 터미널 2 — 클라이언트 (다른 호스트라면 IP만 바꾸면 됨)
python test_client.py --url http://127.0.0.1:8765/mcp

테스트 항목 (14개)

1. initialize — MCP 핸드셰이크, 프로토콜 버전 협상
2. tools/list — 도구 9종 등록 확인 3~6. ping / echo(한글 무결성) / add / get_server_info — 통신 검증
3. search_chemicals('산') — 부분 일치 검색
4. get_chemical(황산) — 상세 조회 값 검증
5. use_chemical(아세톤 250mL) — DB 쓰기(재고 차감) 및 잔량 계산 검증
6. 재고 초과 사용 요청 — isError로 거부되는지 확인
7. usage_history — 방금 기록한 이력이 조회되는지 확인
8. low_stock_report — 발주 필요 목록
9. resources/read chem://inventory — 재고 현황판
10. prompts/get safety_review — 안전 검토 프롬프트

참고: Windows 콘솔에서 한글이 깨지면 $env:PYTHONIOENCODING='utf-8'; python -X utf8 test_client.py로 실행.

Docker

파일	역할
Dockerfile	python:3.11-slim 기반, HTTP 모드(0.0.0.0:8765)로 기동
docker-compose.yml	포트 8765 노출, ./data 볼륨으로 SQLite 영속화
images.tar.gz	docker save 결과물 (약 59MB) — EC2 전송용

로컬 실행

docker build -t chem-inventory-mcp:latest .
docker compose up -d
python test_client.py --url http://127.0.0.1:8765/mcp   # 검증
docker compose down                                      # 중지

SQLite 데이터는 ./data/chem.db에 저장되어 컨테이너를 재생성해도 유지됨. 초기화하려면 data/ 삭제 후 재기동.

EC2 배포 (상세: D:\prj\docs\ec2-deploy-guide.md)

로컬:  docker save chem-inventory-mcp:latest | gzip > images.tar.gz
       copy images.tar.gz Z:\prj\mcp_test\          # 공유드라이브로 VDI 전달
       (코드는 sgpush로 전송 — .sgignore에 *.tar.gz, chem.db, data/ 포함할 것)
VDI:   scp -i <key.pem> images.tar.gz ec2-user@<EC2_IP>:~/
       scp -i <key.pem> -r ~/prj/mcp_test ec2-user@<EC2_IP>:~/mcp_test/
EC2:   docker load < ~/images.tar.gz
       cd ~/mcp_test && mkdir -p data && docker compose up -d

이 서버는 .env가 필요 없음 (비밀값 없음).

Claude Desktop / Claude Code 연동 예시

{
  "mcpServers": {
    "connectivity-test": {
      "command": "python",
      "args": ["D:\\prj\\test\\mcp_test\\server.py"]
    }
  }
}