condensation-mcp
by WillyWilley
README.md
# 결로·곰팡이 판정기 MCP
카카오 PlayMCP 출품작. "우리 집 결로·곰팡이 위험"을 건축물리로 계산해 진단+처방.
기획: [../결로곰팡이판정기_설계.md](../결로곰팡이판정기_설계.md)
## 구조
```
condensation_mcp/
├── engine.py 물리 (노점·표면온도·결로/곰팡이 임계·역산) — 대수식, 의존성 0
├── data.py U값(열관류율)·표면저항 DB = 데이터 해자
├── core.py 입력 해석 + 엔진 호출 + 처방 계산 (순수 함수, 테스트 가능)
├── render.py 카카오톡 ━블록 텍스트 렌더
├── weather.py 기상청 단기예보(k-skill-proxy, 키 불필요) → 지역명→실시간 외기
├── server.py FastMCP — mold_risk 도구 (인터뷰 대본=docstring)
├── poc.py 엔진 검증 데모
└── test_core.py core+render 스모크 테스트
```
데이터 흐름: `카카오 AI → mold_risk(JSON) → core → engine + data → render → ━텍스트 → 그대로 표시`
## 실행
```bash
python -m venv .venv
./.venv/Scripts/python -m pip install -r requirements.txt
# 테스트 / 데모
PYTHONUTF8=1 python test_core.py
PYTHONUTF8=1 python poc.py
# MCP 서버 (Streamable HTTP, http://127.0.0.1:8000/mcp)
./.venv/Scripts/python server.py
```
## 도구
- **mold_risk** — surface_key(단창/이중창/시스템창/외벽_*/내벽) + t_out 필수.
spot·t_in·rh_in·region 선택. rh_in 없으면 **역산 모드**("습도 N% 넘으면 위험").
- list_surfaces — 지원 표면·부위 목록(내부).
## 상태
- ✅ 엔진(노점·표면온도·임계·역산) + 검산(fRsi) — PoC·테스트 통과
- ✅ U값 DB 1차 (창 3 + 벽 4) — 대표값, 정밀 보정 예정
- ✅ MCP 서버(mold_risk) — 도구 등록·호출·HTTP 부팅 검증
- ✅ 기상청 API 연동(지역명→실시간 외기 자동, k-skill-proxy, 키 불필요)
- ⬜ U값 DB 확장(20~30종) + 여름 역결로 + VTT 곰팡이 성장(본선)
- ⬜ PlayMCP in KC 배포
This server cannot be deployed
Maintenance
ActivityStale
ResponsivenessNo issues