关于 Munch
Munch 是一项远程营养追踪服务,供个人记录餐食并管理个人或家庭饮食计划。其认证工具涵盖食物查询、确认后记录餐食、营养历史、食谱、采购清单、目标、饮水和体重。
主要功能
- 01搜索食物并扫描条形码
- 02审核餐食后确认记录
- 03追踪营养历史、饮水、体重和目标
- 04保存食谱并规划餐食
- 05管理采购清单和家庭食谱
适用场景
- 01查询包装食品或食材
- 02确认并记录一餐
- 03规划家庭食谱和采购清单
- 04查看营养趋势和个人目标
MCP 相关
远程 MCP 端点提供经过认证的工具,用于管理营养记录及相关账户数据。准备好的餐食审核结果必须经用户确认后才能永久记录;服务不提供医疗建议。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://munch.business/mcpclaude mcp add --transport http business-munch-munch https://munch.business/mcp{"mcpServers":{"business-munch-munch":{"type":"http","url":"https://munch.business/mcp"}}}在 Cursor 中打开{"servers":{"business-munch-munch":{"type":"http","url":"https://munch.business/mcp"}}}在 VS Code 中打开{"mcpServers":{"business-munch-munch":{"type":"http","url":"https://munch.business/mcp"}}}{"mcpServers":{"business-munch-munch":{"serverUrl":"https://munch.business/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
详细介绍
Munch
Munch 是一项用于个人营养追踪的生产级远程 MCP 服务。它为 ChatGPT 和兼容的 MCP 客户端提供经过身份验证的工具,用于查询食物、审核并确认餐食、持久化营养记录、保存食物、管理食谱、规划餐食、创建购物清单、设定目标、记录饮水和体重、管理账户,以及开展家庭协作。
生产网站:https://munch.business
生产 MCP 端点:https://munch.business/mcp
产品模式
Munch 提供永久免费的 Free 套餐和可选的 Premium 订阅。Premium 只能通过 Munch 网站购买和管理。ChatGPT 连接流程、MCP 工具描述、工具结果和嵌入式小组件均不会宣传价格或发起结账。
Munch 是一款面向消费者的健康产品。它提供营养事实记录和注明来源的估算;不提供医疗建议、诊断、治疗、紧急指导或临床剂量建议。
当前功能
- 搜索 USDA FoodData Central 和 Open Food Facts,包括条码查询。
- 将提供商的结果缓存到 Railway PostgreSQL,同时在已确认的记录中保留不可变的来源快照。
- 根据 ChatGPT 提供的食物候选项准备餐食审核,并要求用户明确确认后才永久记录。
- 存储结构化的餐食、食物条目、营养素、假设、来源信息、饮水、体重和目标。
- 保存并重复使用已确认的食物。
- 创建、搜索、修改、归档、记录和规划个人及家庭食谱;通过审核步骤从公开 URL 导入食谱;管理购物清单。
- 通过经过身份验证的控制项导出账户数据、撤销 MCP 连接并删除账户。
- 渲染独立的 ChatGPT 小组件,用于摘要、趋势、确认和导入工作流。
架构
- 运行时: Bun 和 Hono
- MCP:
@modelcontextprotocol/sdk - 身份验证: Better Auth、通过 Resend 发送的无密码电子邮件,以及兼容 OAuth 2.1 的 MCP 客户端授权
- 数据库: Railway PostgreSQL,强制对用户和家庭数据启用行级安全策略
- 计费: Munch 网站上的 Stripe Checkout 和 Customer Portal
- 食物数据提供商: USDA FoodData Central 和 Open Food Facts
- 托管: Railway,从
main分支部署
Munch 在运行时不使用 Supabase。
隐私和安全边界
Munch 从经过身份验证的会话或 bearer token 中获取用户身份;MCP 工具不接受可选的用户标识符。个人和家庭记录通过数据库角色和行级安全策略在 PostgreSQL 中隔离。破坏性操作需要明确确认,且 CI 会使用一次性账户测试账户删除功能。
公开政策和联系方式:
- 隐私:
https://munch.business/privacy - 条款:
https://munch.business/terms - 帮助:
https://munch.business/help - 安全:
https://munch.business/security - 支持:
[email protected] - 安全问题报告:
[email protected]
请勿在公开的 GitHub issue 中提交凭据、个人营养数据或漏洞详情。
本地开发
要求:
- Bun 1.x
- 兼容 PostgreSQL 17 的数据库
.env.example中说明的环境变量
安装并运行:
bun install --frozen-lockfile
bun run db:migrate
bun run dev
主要质量检查:
bun run format:check
bun run commerce:check
bun run submission:check
bun run typecheck
bun test
完整的 GitHub Actions 测试套件还会将迁移运行两次以验证幂等性,执行 Better Auth/OAuth 冒烟测试、审核账户就绪性检查、营养与家庭数据 RLS 测试、食谱规划测试、账户导出/删除测试、运行就绪性检查,以及生产容器构建。
OpenAI 提交材料
提交材料通过版本控制保存在:
chatgpt-app-submission.jsondocs/openai-submission/
材料包包含上架文案、工具元数据、审核者说明、正向和负向测试用例,以及发布检查清单。生产挑战令牌和审核者密码不会纳入 Git。
归属
Munch 最初是从 Alexander Kutishevsky 采用 MIT 许可证的 Nutrition MCP 项目分叉而来。托管的 Munch 服务由独立团队开发和运营。适用声明请参阅 LICENSE 和 NOTICE.md。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。