🩸 T1D Manager (1형 당뇨 관리 MCP)

카카오 MCP Develop Competition (MCP Player 10) 출품작

1형 당뇨 환자와 보호자를 위한 AI 에이전트 서버입니다. 복잡한 설정 없이도 실시간 혈당 관리와 아픈 날(Sick Day) 케어를 받을 수 있습니다.

📋 PlayMCP 등록 정보

🎯 Lite 버전 (경연용 - OAuth 불필요)

MCP 설명 (복사용):

1형 당뇨 환자와 보호자를 위한 AI 혈당 관리 도우미입니다. 인슐린 용량 계산(ISF/ICR 기반), ISPAD/ADA 임상 가이드라인 기반 아픈 날(Sick Day) 케어, 네이버/다음 하이브리드 검색으로 당뇨 커뮤니티 꿀팁을 제공합니다. OAuth 설정 없이 바로 사용 가능합니다.

🔐 Full 버전 (Dexcom OAuth 포함)

MCP 설명 (복사용):

1형 당뇨 환자와 보호자를 위한 AI 혈당 관리 도우미입니다. Dexcom CGM 실시간 연동(OAuth 2.0)으로 현재 혈당과 추세를 확인하고, ISPAD/ADA 임상 가이드라인 기반 아픈 날(Sick Day) 케어 및 인슐린 계산을 지원합니다. 네이버/다음 하이브리드 검색으로 당뇨 커뮤니티 꿀팁도 제공합니다.

🛠️ 도구 목록

핵심 도구 (Lite/Full 공통)

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. 로컬 실행

# 의존성 설치 (uv 사용 권장)
uv sync

# 서버 실행 (Streamable HTTP on port 8080)
uv run uvicorn src.server:app --host 0.0.0.0 --port 8080

2. MCP Inspector로 테스트

# 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개 도구만 활성화됩니다.

# fly.lite.toml
ENABLE_DEXCOM = "false"

Full 버전

Dexcom OAuth 도구까지 모두 활성화됩니다.

# fly.toml (기본값)
ENABLE_DEXCOM = "true"  # 또는 미설정

📅 To-Do / Roadmap

완료됨

• SSE → Streamable HTTP 마이그레이션

• Sick Day 가이드라인 도구 개선 (JSON 구조화, 의학적 근거 보강)

• Fly.io 배포 완료

• Dexcom Developer Portal 앱 등록 (Sandbox)

• Legacy ID/PW 도구 제거 (심사 기준 준수)

• 도구 최적화 (9개 → 6개)

• Lite/Full 버전 분리 (환경변수 기반)

예정

• Dexcom Production 환경 테스트

• 영양정보 API 연동 (FoodSafetyKorea 등 외부 API)

⚠️ 면책 조항 (Medical Disclaimer)

본 서비스는 의료 기기가 아니며, 제공되는 정보는 참고용입니다. 의학적 결정은 반드시 담당 의료진과 상의해야 합니다. 인슐린 용량 계산이나 Sick Day 관리는 환자의 개별 상황에 따라 달라질 수 있습니다.

📚 관련 문서

• DEPLOYMENT.md: Fly.io 배포 가이드

• GUIDELINE.md: MCP 서버 생성 가이드 및 심사 정책