内容
# 食物追踪器 MCP 服务器
用于跟踪食物摄入和营养的模型上下文协议（MCP）服务器，使用美国农业部（USDA）FoodData Central 数据库。
## 功能特点
- **搜索食物**: 查询 USDA FoodData Central 数据库以获取营养信息
- **记录餐食**: 记录食物摄入量，包括卡路里、宏量营养素和份量
- **跟踪进度**: 查看每日记录与目标的比较
- **设定目标**: 定义每日卡路里、蛋白质、碳水化合物和脂肪的目标
- **获取摘要**: 查看数天、数周或数月的营养平均值
## 安装
### 克劳德桌面
将以下内容添加到克劳德桌面配置文件中：
**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
**Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
```json
{
"mcpServers": {
"food-tracker": {
"command": "npx",
"args": ["-y", "@neonwatty/food-tracker-mcp"],
"env": {
"USDA_API_KEY": "your_api_key_here"
}
}
}
}
```
### 克劳德代码
```bash
claude mcp add food-tracker -e USDA_API_KEY=your_api_key -- npx -y @neonwatty/food-tracker-mcp
```
或添加到 `~/.claude.json`:
```json
{
"mcpServers": {
"food-tracker": {
"command": "npx",
"args": ["-y", "@neonwatty/food-tracker-mcp"],
"env": {
"USDA_API_KEY": "your_api_key_here"
}
}
}
}
```
## 要求
### 美国农业部 API 密钥
在 https://fdc.nal.usda.gov/api-key-signup/ 获取免费的 API 密钥。
## 可用工具
### 搜索食物
在 USDA FoodData Central 数据库中搜索食物。
```
"搜索鸡胸肉"
```
返回每 100 克份量的营养信息，包括卡路里、蛋白质、碳水化合物和脂肪。
### 记录食物
记录每日食物日记中的食物条目。
```
"记录 200 克烤鲑鱼用于午餐，含 400 卡路里，40 克蛋白质，0 克碳水化合物，22 克脂肪"
```
参数：
- `food_name`（必填）：食物名称
- `serving_size`（必填）：份量
- `serving_unit`（必填）：单位（克、盎司、杯、件等）
- `calories`（必填）：此份量的卡路里
- `protein_g`：蛋白质（克）
- `carbs_g`：碳水化合物（克）
- `fat_g`：脂肪（克）
- `fiber_g`：纤维（克）
- `meal`：早餐、午餐、晚餐或小吃
- `date`：日期（YYYY-MM-DD 格式，默认为今天）
### 获取每日记录
获取特定日期的所有食物条目，包括总量和目标比较。
```
"今天我吃了什么？"
"显示 2025-01-15 的食物记录"
```
### 设定目标
设定每日营养目标。
```
"将我的每日目标设定为 2000 卡路里，150 克蛋白质，200 克碳水化合物和 65 克脂肪"
```
### 获取摘要
获取指定日期范围的营养摘要和平均值。
```
"显示我本周的营养摘要"
"获取我的月度营养平均值"
```
### 删除条目
按 ID 删除食物记录条目。
```
"删除条目 5"
```
## 数据存储
食物记录存储在 `~/.food-tracker/food.db` 的 SQLite 数据库中。您的数据不会离开您的机器。
## 示例对话
**您**: 搜索燕麦
**克劳德**: 找到 10 种匹配 "燕麦" 的食物...
**您**: 记录 1 杯燕麦用于早餐
**克劳德**: 记录：燕麦（1 杯）- 150 卡路里 | 蛋白质：5 克 | 碳水化合物：27 克 | 脂肪：3 克
**您**: 今天我吃了什么？
**克劳德**: 2025-01-15 的食物记录...
## 许可证
MIT 许可证 - 参见 [LICENSE](LICENSE) 获取详细信息。
## 贡献
欢迎贡献！请在 [GitHub](https://github.com/neonwatty/food-tracker-mcp) 上提出问题或提交拉取请求。
