MCP 葡萄糖服务器
一个模型上下文协议(MCP)服务器,为像Claude和ChatGPT这样的AI助手提供血糖数据查询工具。连接至 health-data-storage 获取葡萄糖读数的API。
🎯 目的
这个MCP服务器充当一个 专用接口 在人工智能助手与您的血糖数据之间,它提供了自然语言工具来查询血糖水平、趋势和统计数据。
🏗️ 建筑职位
┌──────────────────────┐
│ health-data-storage │
│ REST API │
└──────────┬───────────┘
│ HTTP GET
▼
┌──────────────┐
│ mcp-glucose │ ← YOU ARE HERE
│ (MCP Server) │
└──────┬───────┘
│ MCP Tools
▼
┌───────────────┐
│ Claude/ChatGPT│
└───────────────┘🔧 可用工具
1. get_glucose_readings
在指定日期范围内获取血糖读数。
参数:
userId(可选):用户标识符(默认为 USER_ID 环境变量)startDate(可选):以 ISO 8601 格式指定开始日期endDate(可选):结束日期,采用ISO 8601格式limit(可选):最大读数数量(默认:1000)
示例查询:
- “我今天血糖怎么样?”
- “给我看一下过去一周的血糖读数”
- “给我从10月1日到10月22日的血糖水平数据”
2. get_latest_glucose
获取最新的血糖读数。
参数:
userId(可选):用户标识符(默认使用 USER_ID 环境变量)
示例查询:
- “我现在的血糖是多少?”
- “我最后一次的血糖读数是多少?”
- “检查一下我最近的血糖”
3. get_glucose_stats
获取一段时间内的葡萄糖统计数据(数量、平均值、最小值、最大值)。
参数:
userId(可选):用户标识符(默认为 USER_ID 环境变量)startDate(可选):以ISO 8601格式表示的开始日期endDate(可选):以ISO 8601格式表示的结束日期
示例查询:
- “我这周的平均血糖是多少?”
- “给我显示过去一个月的血糖数据”
- “我昨天的血糖值是多少?”
🚀 设置
先决条件
- Node.js 20多个版本(或:Node.js 20+版本)
- 访问已部署的
health-data-storage例子 - API认证密钥
安装
# Install dependencies
npm install
# Build TypeScript
npm run build配置
创建一个 .env 文件(或设置环境变量):
STORAGE_API_URL=https://your-storage-api.run.app
API_SECRET=your-api-secret
USER_ID=user@example.com # Optional default user与Claude桌面版的使用
添加到 ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"glucose": {
"command": "node",
"args": ["/path/to/mcp-glucose/build/index.js"],
"env": {
"STORAGE_API_URL": "https://your-storage-api.run.app",
"API_SECRET": "your-api-secret",
"USER_ID": "user@example.com"
}
}
}
}重启Claude桌面版。
与ChatGPT的使用
*(ChatGPT MCP支持即将推出)*
💬 示例对话
配置完成后,您可以向Claude询问:
简单查询:
“我最近的血糖是多少?”
{
"value": 95,
"unit": "mg/dL",
"date": "2025-10-22T10:30:00Z",
"source": "Lingo"
}时间范围查询:
“给我看看过去24小时的血糖情况”
{
"count": 48,
"readings": [
{ "value": 95, "unit": "mg/dL", "date": "2025-10-22T10:30:00Z", "source": "Lingo" },
...
]
}统计查询:
“我这周的平均血糖是多少?”
{
"count": 336,
"average": 98.5,
"min": 75,
"max": 125,
"unit": "mg/dL"
}分析查询:
“分析我过去一个月的血糖模式”
克劳德将使用这些工具来获取数据,并对您的血糖趋势、模式和洞察提供智能分析。
🔗 相关项目
- 健康数据存储此服务器查询的存储后端
- 健康追踪应用收集血糖数据的iOS应用程序
- mcp-activity 翻译为中文是“MCP活动”或“MCP行动计划”(具体翻译取决于上下文,MCP可能代表某个特定的项目、计划或活动名称)(未来的)用于活动/锻炼数据的MCP服务器
- MCP-营养(或:MCP营养学)(未来的)用于食品/营养数据的MCP服务器
📈 未来改进方向
可能的补充内容:
- 趋势分析工具检测血糖峰值、模式
- 相关性工具将血糖与饮食、运动进行比较
- 警报工具当血糖超出范围时发出通知
- 导出工具生成报告、图表
- 多用户支持查询多个用户的数据
🛠️ 开发
本地测试
# Build
npm run build
# Run (will use stdio transport)
npm start根据MCP规范,该服务器通过stdio(标准输入/输出)运行。可与Claude Desktop或MCP检查器一起使用进行测试。
使用MCP Inspector进行测试
npm install -g @modelcontextprotocol/inspector
npx @modelcontextprotocol/inspector node build/index.js📝 许可证
麻省理工学院(MIT)
