mcpField
M
MealMasteryAI

MealMasteryAI

本地服务
github.com/MealMasteryAI健康医疗030 周前更新

关于 MealMasteryAI

MealMasteryAI 是一款 MCP 服务,可通过自然语言使用 MealMastery 的膳食规划功能,适用于管理膳食计划、食谱、偏好和购物清单的人群。它在同一集成中提供工具、只读资源和引导式提示词。

主要功能

  1. 01生成并管理膳食计划
  2. 02搜索、保存和评价食谱
  3. 03创建和更新购物清单
  4. 04将购物清单发送到 Instacart 或 Kroger
  5. 05读取用户偏好和计划资源
  6. 06流式显示膳食生成进度

适用场景

  1. 01根据偏好制定每周膳食计划
  2. 02替换现有计划中的一餐
  3. 03根据膳食计划生成购物清单
  4. 04将购物清单发送给已连接的服务商

MCP 相关

向 MCP 客户端提供 24 个工具、3 个只读资源和 4 个提示词模板。对于提供 progress token 的客户端,膳食计划生成可发送进度通知。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
"mcpServers": {
"mealmasteryai": {
"command": "npx",
"args": [
"-y",
"@mealmastery/mcp-server"
],
"env": {
"MEALMASTERY_API_KEY": "<MEALMASTERY_API_KEY>"
}
}
}
}
启动命令npx -y @mealmastery/mcp-server
需要配置的环境变量
MEALMASTERY_API_KEY密钥Your MealMastery developer API key (get one at mealmastery.ai/settings)

本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。

安装包
npm@mealmastery/mcp-server0.2.4

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。

详细介绍

@mealmastery/mcp-server

MealMastery AI 膳食规划 MCP 服务。可与 Claude Desktop、VS Code Copilot 及其他兼容 MCP 的 AI Agent 集成。

设计理念

MCP 服务是核心功能的映射,而不是新功能的首发平台。它的价值主张是:

“在应用中能做的一切,现在都可以通过与 Claude 自然对话来完成。”

MCP 层提供便利性(自然语言)和组合能力(串联工具),但底层功能首先存在于核心产品中。新功能应先作为 API 端点构建,为 Web/移动应用提供支持,然后再通过 MCP 暴露出来——绝不能反过来。

设置

  1. 从 MealMastery 设置 获取 API 密钥
  2. 添加到 Claude Desktop 配置文件(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 密钥配额(根据订阅层级设置的每日请求限制)。免费层级:每天 1,000 次请求。付费层级:每天 10,000 次请求。

可用工具

用户上下文
  • get_user_context - 加载完整的用户资料、偏好、订阅信息和最新计划
  • get_user_preferences - 获取饮食偏好和烹饪设置
  • update_user_preferences - 更新饮食、过敏或菜系偏好
  • get_subscription_status - 查看订阅层级和使用限额
  • get_checkout_providers - 查看已连接的食品杂货服务商(Instacart、Kroger)
  • checkout_grocery_list - 将购物清单发送至 Instacart 或 Kroger
膳食规划
  • generate_meal_plan - 使用 AI 生成个性化膳食计划(支持流式进度)
  • get_latest_meal_plan - 获取当前/最新的膳食计划
  • get_meal_plan - 根据 ID 获取指定的膳食计划
  • list_meal_plans - 浏览膳食计划历史记录
  • regenerate_meal - 用 AI 生成的新餐食替换计划中的一餐
  • generate_and_add_meal - 在指定时段向计划中添加一道 AI 生成的新餐食
  • remove_meal - 从计划中移除一餐
食谱
  • search_recipes - 搜索已保存的食谱
  • get_recipe - 获取食谱完整详情
  • save_meal_as_recipe - 将生成的餐食保存为可重复使用的食谱
  • get_favorite_recipes - 获取收藏的食谱列表
  • favorite_meal - 将一餐标记为收藏
  • get_meal_ratings - 获取计划中餐食的评分
  • get_all_ratings - 获取所有时间范围内的食谱评分
购物
  • generate_grocery_list - 根据膳食计划创建购物清单
  • get_grocery_list - 获取指定的购物清单
  • list_grocery_lists - 浏览购物清单历史记录
  • update_grocery_items - 勾选、排除或调整购物清单项目

环境变量

变量必填默认值描述
MEALMASTERY_API_KEY是-您的开发者 API 密钥(mm_live_...)
MEALMASTERY_API_URL否https://api.mealmastery.aiAPI 基础 URL

安全性

  • API 密钥会被交换为短时效 JWT(15 分钟)——数据请求中不会发送 API 密钥
  • 所有非 localhost 连接均强制使用 HTTPS
  • 基于作用域的访问控制(read、write、checkout、admin)
  • 由服务器端强制执行每个密钥的每日配额
  • 错误消息经过清理,不会向 Agent 泄露内部 API 详细信息

开发

npm install
npm run build
npm start

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。