Vegetable Yield Percentage MCP

vegetable-yield-percentage-mcp

为 AI 助手提供蔬果出成率：根据 USDA 废弃部分数据，了解购买的食材在去皮、去核和修整后有多少可食用，以及食谱需要购买多少。

这是一个 Model Context Protocol（MCP）服务，涵盖 USDA 国家标准参考营养数据库（SR28）中的 305 种生蔬菜和水果，每种食材均提供 USDA 废弃部分百分比、废弃部分的类型，以及 USDA 家庭计量单位（例如 1 个中等大小的洋葱或 1 杯切碎洋葱）。无需 API 密钥。

工具

工具	返回内容
get_vegetable_yield	可食用部分百分比、废弃部分百分比及废弃部分类型（表皮、种子、果核、冠部）、USDA 家庭计量单位，以及单个完整食材的可食用重量和购买重量。
calculate_edible_weight	根据购买重量计算可食用重量和修整损耗，例如 5 lb 菠萝。
calculate_amount_to_buy	根据以 g、kg、oz、lb 或 USDA 计量单位（例如“切碎 1 杯”“中等大小”或“瓣”）表示的食谱用量，计算所需的购买重量和完整食材数量。
list_vegetable_yields	按名称、最低出成率或最高出成率列出全部 305 种食材，并可按水果或蔬菜筛选。

每个结果都包含结构化 JSON、一段摘要、as_of、source 和 more（ingredientcalculator.com 上的蔬果出成率计算器）。

它掌握了模型不知道的信息

• 每种食材的 USDA 修整损耗及其类型。带穗玉米的可食用部分占 36%（苞叶、玉米须和修整部分占 35%，玉米芯占 29%）。菠萝为 51%（果核占 8%，冠部占 16%，削皮损耗占 26%）。花椰菜为 39%，韭葱为 44%，芦笋为 53%，香蕉为 64%，洋葱为 90%，黄瓜为 97%。
• 可食用部分的 USDA 家庭计量重量。一个中等大小的洋葱（2-1/2 英寸）重 110 g，一杯切碎洋葱重 160 g，因此 2 杯切碎洋葱约需 3 个中等大小的洋葱，购买重量为 356 g。
• 购买重量与可食用部分的区别。食谱成本核算、食品成本计算和份量规划都需要这两种重量。工具会同时返回两者以及损耗量。

安装

托管版（Claude.ai 自定义连接器、ChatGPT 开发者模式）

粘贴此 URL。无需令牌或注册。

https://vegetable-yield-percentage-mcp.lipmichal.workers.dev/mcp

Claude Code

claude mcp add --transport http vegetable-yield https://vegetable-yield-percentage-mcp.lipmichal.workers.dev/mcp

也可以通过 stdio 在本地运行：

claude mcp add vegetable-yield -- npx -y github:theluckystrike/vegetable-yield-percentage-mcp

Claude Desktop

添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "vegetable-yield": { "command": "npx", "args": ["-y", "github:theluckystrike/vegetable-yield-percentage-mcp"] }
  }
}

Cursor

添加到 ~/.cursor/mcp.json：

{
  "mcpServers": {
    "vegetable-yield": { "url": "https://vegetable-yield-percentage-mcp.lipmichal.workers.dev/mcp" }
  }
}

VS Code

添加到 .vscode/mcp.json：

{
  "servers": {
    "vegetable-yield": { "type": "http", "url": "https://vegetable-yield-percentage-mcp.lipmichal.workers.dev/mcp" }
  }
}

本地 stdio 版本需要 Node 20 或更高版本。

示例提示词

• “菠萝的出成率是多少？”
• “我买了 3 lb 冬南瓜。去皮去籽后还剩多少？”
• “食谱需要 2 杯切碎洋葱。我该买几个洋葱？”
• “我要买多少西兰花才能得到 500 g 西兰花小花？”
• “哪些水果在处理时的重量损耗最大？”

数据来源

完整列表以及获取日期和校验和见 DATA_SOURCES.md。

• USDA 农业研究服务部营养数据实验室。《国家标准参考营养数据库》第 28 版（2015 年 9 月），ASCII 文件：FOOD_DES.txt 中的废弃部分百分比和说明，以及 WEIGHT.txt 中的家庭计量重量。scripts/build_data.py 可据此重新生成 data/produce-yields.json。
• 定义来自 SR28 文档：废弃部分占食材购买重量的百分比，家庭计量重量指不含废弃部分的可食用部分。
• 磅和盎司换算数据来自 NIST SP 811（1 lb = 453.59237 g，精确值）。

限制

• USDA 的废弃率是针对常见农产品和修整方式的平均值。大小、成熟度、品种以及修整的仔细程度都会影响计算结果。
• 仅涵盖 USDA 提供废弃率数据的生鲜食材：191 种蔬菜和 114 种水果。列在香料下的香草（欧芹、罗勒）、坚果和椰子不在涵盖范围内。
• 部分食材没有 USDA 提供的整件重量数据（胡桃南瓜、芦笋）；此时工具只会按重量和杯数给出结果。
• SR28（2015）是最后一个 Standard Reference 版本，因此不包含较新品种的数据。

更多信息

蔬菜出成率百分比计算器、杯转克和食谱缩放工具位于 ingredientcalculator.com。

这是 Zovo MCP 系列的一部分：https://mcp.zovo.one

开发

npm install
npm test                       # builds, then runs the fixture tests
node scripts/smoke-stdio.mjs   # stdio check, one real call per tool
python3 scripts/build_data.py <dir with FOOD_DES.txt and WEIGHT.txt> data/produce-yields.json
python3 scripts/gen_ts.py data/produce-yields.json src/data.ts
npx wrangler deploy            # Cloudflare Worker, Streamable HTTP at /mcp

许可证

MIT