使用说明
@餐控/mcp服务器
用于MealMastery AI膳食计划的MCP服务器。与Claude Desktop、VS Code Copilot和其他MCP兼容的AI代理集成。
哲学
MCP服务器是 核心能力的镜像,不是新功能首次亮相的地方。其价值主张是:
“你在应用程序中能做的一切,现在都可以通过克劳德的自然对话来完成。”
MCP层增加了便利性(自然语言)和可组合性(链接工具),但底层功能首先存在于核心产品中。新功能应该作为API端点构建,为网络/移动应用程序提供动力,然后通过MCP公开,而不是相反。
设置
- 从获取API密钥 MealMastery设置
- 添加到您的Claude桌面配置(
claude_desktop_config.json):
{
"mcpServers": {
"mealmastery": {
"command": "npx",
"args": ["-y", "@mealmastery/mcp-server"],
"env": {
"MEALMASTERY_API_KEY": "mm_live_..."
}
}
}
}
特性
24工具
用于膳食计划、食谱、杂货清单和用户偏好的完整CRUD,以及具有流式进度的AI生成。
3资源(只读上下文)
| 资源URI | 描述 |
|---|---|
mealmastery://meal-plan/current |
包含所有餐点和营养的最新膳食计划 |
mealmastery://user/preferences |
饮食偏好、过敏、技能水平 |
mealmastery://grocery-list/current |
当前膳食计划的杂货清单 |
4提示模板(指导工作流程)
| 提示 | 描述 |
|---|---|
weekly-meal-prep |
全周计划:生成计划、审核、购物清单、结账 |
swap-meal |
在当前计划中替换一顿饭 |
order-groceries |
预览并将购物清单发送到Instacart/Kroger |
quick-dinner |
有时间限制的单顿快餐想法 |
流媒体和进度
这个 generate_meal_plan 该工具支持MCP进度通知。客户端发送 progressToken 在AI生成过程中接收实时更新(0-100%的进度和状态消息)。没有进度支持的客户端会优雅地回退到非流式端点。
配额意识
API密钥配额(基于订阅层的每日请求限制)在每个令牌交换上报告。免费等级:1000次请求/天。付费层:10000次请求/天。
可用工具
用户上下文
- get_user_context -加载完整的用户配置文件、首选项、订阅和最新计划
- get_user_参考信息 -获取饮食偏好和烹饪设置
- update_user_参考信息 -更新饮食、过敏或烹饪偏好
- 获取订阅状态 -检查订阅级别和使用限制
- get_checkout_提供者 -查看连接的杂货供应商(Instacart、Kroger)
- checkout_grocery_list -将购物清单发送到Instacart或Kroger
膳食计划
- generate_mail_plan -使用AI生成个性化膳食计划(具有流式进度)
- get_latest_meal计划 -获取当前/最近的用餐计划
- get_mal_plan -按ID获取特定的用餐计划
- list_meal计划 -浏览膳食计划历史记录
- 再生_铝 -用人工智能生成的新餐代替计划中的一餐
- 发电机和发电机 -在特定时段将新的AI餐添加到计划中
- remove_meal -从计划中删除一顿饭
食谱
- 搜索密码 -搜索已保存的食谱
- 获取密码 -获取完整的食谱详细信息
- save_mail_as_recipe -将生成的膳食保存为可重复使用的食谱
- 获取美食食谱 -获取喜爱的食谱列表
- favorite_mal -将一顿饭标记为最喜欢的
- get_mal_ratings -获取计划中膳食的评级
- 获取所有标记 -获得历史食谱评级
杂货
- 生成器_杂货店_列表 -根据膳食计划创建购物清单
- 获取程序列表 -获取特定的杂货清单
- list_grocery_lists -浏览购物清单历史记录
- update_grocery_items -检查、排除或调整杂货
环境变量
| 变量 | 必填 | 默认 | 描述 |
|---|---|---|---|
MEALMASTERY_API_KEY |
是 | - | 您的开发人员API密钥(mm_live_...) |
MEALMASTERY_API_URL |
没有 | https://api.mealmastery.ai |
API基本URL |
安全
- API密钥交换为短暂的JWT(15分钟)——从不在数据请求中发送
- 对所有非本地主机连接强制使用HTTPS
- 基于作用域的访问控制(读、写、签出、管理)
- 服务器端强制执行按密钥的每日配额
- 已清除错误消息--没有内部API详细信息泄漏到代理
发展
npm install
npm run build
npm start