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

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

구성

Related MCP server: mcp_inventory

기능 (Tools)

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

로컬 실행

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"]
    }
  }
}