T1D Manager

# 🩸 T1D Manager (1형 당뇨 관리 MCP) <p align="center"> <img src="./t1d_mcp_icon.png" alt="T1D Manager Icon" width="200"/> </p> **카카오 MCP Develop Competition (MCP Player 10) 출품작** 1형 당뇨 환자와 보호자를 위한 **AI 에이전트 서버**입니다. 복잡한 설정 없이도 실시간 혈당 관리와 아픈 날(Sick Day) 케어를 받을 수 있습니다. --- ## 📋 PlayMCP 등록 정보 ### 🎯 Lite 버전 (경연용 - OAuth 불필요) | 항목 | 값 | |------|-----| | **MCP 이름** | T1D Manager Lite | | **MCP Endpoint** | `https://t1d-mcp-lite.fly.dev/mcp` | | **도구 개수** | 3개 | **MCP 설명 (복사용)**: > 1형 당뇨 환자와 보호자를 위한 AI 혈당 관리 도우미입니다. 인슐린 용량 계산(ISF/ICR 기반), ISPAD/ADA 임상 가이드라인 기반 아픈 날(Sick Day) 케어, 네이버/다음 하이브리드 검색으로 당뇨 커뮤니티 꿀팁을 제공합니다. OAuth 설정 없이 바로 사용 가능합니다. --- ### 🔐 Full 버전 (Dexcom OAuth 포함) | 항목 | 값 | |------|-----| | **MCP 이름** | T1D Manager | | **MCP Endpoint** | `https://t1d-mcp.fly.dev/mcp` | | **도구 개수** | 6개 | **MCP 설명 (복사용)**: > 1형 당뇨 환자와 보호자를 위한 AI 혈당 관리 도우미입니다. Dexcom CGM 실시간 연동(OAuth 2.0)으로 현재 혈당과 추세를 확인하고, ISPAD/ADA 임상 가이드라인 기반 아픈 날(Sick Day) 케어 및 인슐린 계산을 지원합니다. 네이버/다음 하이브리드 검색으로 당뇨 커뮤니티 꿀팁도 제공합니다. --- ## 🛠️ 도구 목록 ### 핵심 도구 (Lite/Full 공통) | 도구 | 설명 | |------|------| | `calculate_insulin_dosage` | 혈당/탄수화물 기반 인슐린 용량 계산 | | `search_diabetes_community` | 네이버/다음 하이브리드 검색 (환자 경험담, 꿀팁) | | `analyze_sick_day_guidelines` | ISPAD/ADA 기반 아픈 날 케어 가이드라인 | ### Dexcom 도구 (Full 버전만) | 도구 | 설명 | |------|------| | `get_dexcom_auth_url` | Dexcom OAuth 인증 URL 생성 | | `get_cgm_sandbox` | Authorization Code로 CGM 데이터 조회 | | `get_cgm_with_token` | Access Token으로 CGM 데이터 조회 | --- ## 💬 대화 예시 | 번호 | 예시 | |------|------| | 1 | 밥 먹으려는데 탄수화물 60g이야. 인슐린 얼마나 맞아야 해? | | 2 | 나 열나고 토했어. 어떻게 해야 해? | | 3 | 저혈당 간식 추천해줘 | | 4 | Dexcom 로그인 할래 (Full 버전) | --- ## ✨ 핵심 기능 ### 1. 🍽️ 스마트 인슐린 계산 - **기능**: 혈당/탄수화물 입력 시 정확한 인슐린 용량과 교육 자료를 **구조화된 JSON**으로 반환합니다. - 할루시네이션 없는 정확한 계산을 보장합니다. ### 2. 🏥 아픈 날 (Sick Day) 케어 - **기능**: \"나 열 나고 토했어\" → ISPAD/ADA 가이드라인 기반 위험도 분석 및 행동 지침 제공. - **데이터**: 수분 섭취, 케톤 측정, 응급실 방문 기준 등 안전한 의료 지침을 안내합니다. ### 3. 🔍 하이브리드 커뮤니티 검색 - **기능**: 네이버 블로그(환자 경험담)와 다음 웹(정보)을 동시에 검색하여 실질적인 꿀팁을 제공합니다. ### 4. 📊 Dexcom CGM 실시간 연동 (Full 버전) - **기능**: Dexcom 공식 Developer API (OAuth 2.0) 지원으로 실시간 혈당 및 추세 확인. --- ## 🛠️ 기술 스택 & 구조 - **Core**: Python 3.12, `mcp` (Model Context Protocol), `FastMCP` - **Transport**: **Streamable HTTP** (MCP 표준 준수) - **Integrations**: Dexcom Developer API (OAuth), Naver/Kakao Search - **Infra**: Docker, Fly.io ``` t1d-mcp/ ├── src/ │ ├── server.py # Streamable HTTP Server Entrypoint │ ├── main.py # FastMCP Tool Definitions │ ├── tools/ │ │ └── dexcom_tools.py # Dexcom OAuth Tools (조건부 로드) │ ├── cgm/ # Dexcom Official API Client │ ├── treatment/ # Sick Day Logic, Insulin Calc │ └── community/ # Hybrid Search └── tests/ # 단위 테스트 ``` --- ## 🚀 시작하기 ### 1. 로컬 실행 ```bash # 의존성 설치 (uv 사용 권장) uv sync # 서버 실행 (Streamable HTTP on port 8080) uv run uvicorn src.server:app --host 0.0.0.0 --port 8080 ``` ### 2. MCP Inspector로 테스트 ```bash # Lite 버전 (OAuth 없음) npx @modelcontextprotocol/inspector --transport http --server-url https://t1d-mcp-lite.fly.dev/mcp # Full 버전 (Dexcom 포함) npx @modelcontextprotocol/inspector --transport http --server-url https://t1d-mcp.fly.dev/mcp ``` --- ## 🔧 환경 설정 ### Lite 버전 (기본) Dexcom 도구 없이 핵심 3개 도구만 활성화됩니다. ```bash # fly.lite.toml ENABLE_DEXCOM = "false" ``` ### Full 버전 Dexcom OAuth 도구까지 모두 활성화됩니다. ```bash # fly.toml (기본값) ENABLE_DEXCOM = "true" # 또는 미설정 ``` --- ## 📅 To-Do / Roadmap ### 완료됨 - [x] SSE → Streamable HTTP 마이그레이션 - [x] Sick Day 가이드라인 도구 개선 (JSON 구조화, 의학적 근거 보강) - [x] Fly.io 배포 완료 - [x] Dexcom Developer Portal 앱 등록 (Sandbox) - [x] Legacy ID/PW 도구 제거 (심사 기준 준수) - [x] 도구 최적화 (9개 → 6개) - [x] Lite/Full 버전 분리 (환경변수 기반) ### 예정 - [ ] Dexcom Production 환경 테스트 - [ ] 영양정보 API 연동 (FoodSafetyKorea 등 외부 API) --- ## ⚠️ 면책 조항 (Medical Disclaimer) > 본 서비스는 의료 기기가 아니며, 제공되는 정보는 참고용입니다. > 의학적 결정은 반드시 담당 의료진과 상의해야 합니다. > 인슐린 용량 계산이나 Sick Day 관리는 환자의 개별 상황에 따라 달라질 수 있습니다. ### 📚 관련 문서 - [DEPLOYMENT.md](./DEPLOYMENT.md): Fly.io 배포 가이드 - [GUIDELINE.md](./GUIDELINE.md): MCP 서버 생성 가이드 및 심사 정책