糖尿病管理助手

T1D Manager是一款为1型糖尿病患者及其护理人员设计的AI代理服务,提供实时血糖管理、胰岛素剂量计算、病日护理指南及糖尿病社区搜索功能。

  • by JunHyungKang
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 JunHyungKang/t1d-mcp

使用说明

🩸 T1D Manager(1型糖尿病管理MCP)

Kakao MCP Develop Competition(MCP Player 10)参赛作品

为1型糖尿病患者和监护人 AI代理服务器是。 无需复杂的设置,即可获得实时血糖管理和生病日(Sick Day)护理。


📋 PlayMCP属性

🎯 Lite版本(用于竞赛-无需OAuth)

项目 值
MCP名称 T1D管理器精简版
MCP端点 https://t1d-mcp-lite.fly.dev/mcp
工具计数 3个

MCP说明(复制):

为1型糖尿病患者和监护人提供AI血糖管理帮助。胰岛素用量计算(基于ISF/ICR)、基于ISPAD/ADA临床指南的生病日(Sick Day)护理、NAVER/下一步混合搜索提供糖尿病社区秘诀。无需OAuth设置即可使用。


🔐 完整版本(包括Dexcom OAuth)

项目 值
MCP名称 T1D经理
MCP端点 https://t1d-mcp.fly.dev/mcp
工具计数 6个

MCP说明(复制):

为1型糖尿病患者和监护人提供AI血糖管理帮助。通过Dexcom CGM实时联动(OAuth 2.0)确认当前血糖和趋势,支持基于ISPAD/ADA临床指南的生病日(Sick Day)护理和胰岛素计算。NAVER/下一个混合搜索还提供糖尿病社区的秘诀。


🛠️ 工具列表

核心工具(Lite/Full通用)

工具 说明
calculate_insulin_dosage 基于血糖/碳水化合物的胰岛素用量计算
search_diabetes_community NAVER/下一个混合搜索(患者经验谈,秘诀)
analyze_sick_day_guidelines 基于ISPAD/ADA的生病日护理指南

Dexcom工具(仅完整版)

工具 说明
get_dexcom_auth_url 生成Dexcom OAuth验证URL
get_cgm_sandbox 使用Authorization Code查询CGM数据
get_cgm_with_token 使用Access Token查询CGM数据

💬 对话示例

编号示例 |------|------| 想吃饭,碳水化合物60克。胰岛素要打多少? | 我发烧了,吐了。该怎么办? | 推荐低血糖零食 |4|我要登录Dexcom(完整版)|


核心功能

1. 🍽️ 智能胰岛素计算

  • 功能:输入血糖/碳水化合物时准确的胰岛素用量和教育资料 结构化的JSON返回。
  • 确保准确计算,无需卤素。

2. 🏥 生病的日子(Sick Day)护理

  • 功能:“我发烧呕吐了”→提供基于ISPAD/ADA准则的危险度分析和行动指南。
  • 数据:指导安全的医疗指南,包括水分摄入、酮测定、急诊室访问标准等。

3. 🔍 搜索混合社区

  • 功能:同时搜索NAVER博客(患者体验)和以下网络(信息),提供实际的提示。

4. 📊 Dexcom CGM实时集成(完整版)

  • 功能:通过Dexcom官方Developer API(OAuth 2.0)支持实时确认血糖和趋势。

🛠️ 技术堆栈和结构

  • 核心Python 3.12, mcp (模型上下文协议), FastMCP
  • 运输: 流式HTTP (符合MCP标准)
  • 集成:Dexcom开发者API(OAuth),Naver/Kakao搜索
  • 基础设施: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工具,只有三个核心工具处于活动状态。

# fly.lite.toml
ENABLE_DEXCOM = "false"

完整版本

甚至Dexcom OAuth工具都处于活动状态。

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

📅 待办事项/路线图

完成

  • [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生产环境
  • []营养信息API集成(FoodSafetyKorea等外部API)

免责声明(Medical Disclaimer)

本服务不是医疗器械,提供的信息仅供参考。 医学决定必须与负责的医护人员商量。 胰岛素用量计算或Sick Day管理可能会根据患者的个人情况而有所不同。

📚 相关文档