nutrition

Heathy — 营养数据（MCP 服务）

涵盖1,100 多种完整植物性食物及其面粉和 39 种阿育吠陀草药的营养数据，来源于覆盖 26 个国家的 30 份食物成分表，以及西非、太平洋地区的数据和 FAO 全球生物多样性表 — 包括 IFCT 2017（印度）。它还可以回答已发布的数据支持哪些英国／欧盟和美国营养声称，适用于生鲜完整食物或未强化面粉。

端点： https://mcp.heathy.org/mcp — Streamable HTTP（JSON-RPC 2.0） 网站： https://heathy.org · 联系邮箱： [email protected] 运营方： CCT Technologies Ltd（英格兰和威尔士，注册号 06337577） 预览期间免费。

此代码库不包含服务端代码 — 只有清单、这些说明和一个 Dockerfile。该服务托管于云端；无需安装任何内容。Dockerfile 仅用于将 stdio 桥接到托管端点，供在容器中检查服务的目录使用。

---

有何不同

大多数营养 API 只返回单个国家表中的一个数值。此服务会返回数值及其来源信息：

• 有该食物数据集之间的中位数，
• 有多少个来源参与计算，以及具体是哪些来源，
• 来源之间的最小值–最大值范围，以及每个来源自己的数值。

因此，Agent 可以引用数据，而不是直接断言某个数值；还可以判断各个来源是否存在分歧。例如，番石榴的维生素 C 数据为 222 mg — 这是 13 份表格的中位数，范围为 68–273 — 并列出了 20 个国家的数值。这个范围确实存在：不同国家的土壤、栽培品种和分析方法各异，因此在将某个数值作为事实陈述之前，了解这一点很有价值。

印度食物的数据来自 IFCT 2017，因此关于苦瓜、马豆或小米的问题会根据印度数据作答，而不是使用美国数据替代。

交叉核验的范围

使用数据时，请留意覆盖范围：

• 不到一半的食物有两份或更多表格的数据 — 常见农产品最多可有 26 份。
• 超过一半的食物仅来自一份表格。它们的 sources 数量为 1；没有其他数据可用于交叉核验。请在 nutrient_ranking 中使用 min_sources，将这些食物排除在排名之外；排除项会列在排名旁边。
• 某些表格的许可允许展示数据，但不允许计算平均值。这些数值会显示在 by_source 下，但不会计入中位数，因此 sources 数量可能少于列出的数值数量。

连接

添加到任何支持远程服务的 MCP 客户端：

{
  "mcpServers": {
    "heathy": {
      "type": "streamable-http",
      "url": "https://mcp.heathy.org/mcp"
    }
  }
}

无需 API 密钥，也无需注册。服务卡介绍了此服务，地址为 https://mcp.heathy.org/.well-known/mcp/server-card.json。

工具

lookup_food

整株植物性食物或面粉每 100 g 的完整营养成分信息，附带来源。

参数	类型
food	string	必填 — slug、通用名称或地区别名
nutrients	string[]	可选 — 仅返回指定营养素，而非完整成分信息

完整成分信息涵盖约 130 种营养素，另有标记为 tier: "research" 的研究级别（覆盖较少，或只是重述其他营养素）。

名称不是完全匹配时的返回结果：

• 日常名称（“potato”“kela”“besan”）会匹配大多数国家级数据库收录的食物。如果匹配较宽泛，答案会在 matched_from 中说明，并列出可能对应的其他食物。
• 日常营养素名称（“fiber”“omega 3”“calories”“vit c”）也能识别。无法识别的名称会列在 unrecognised_nutrients 中；答案的其余内容仍会返回。
• 烹饪或加工形式（“lentils boiled”“brown rice cooked”）会被拒绝，并在回复中指出数据库收录的未加工食物。不会以未加工食物的数据替代返回：每 100 g 的数据对应的是不同食物。
• 数据库未收录的食物 — 动物性食物、植物制成的食品（豆腐、意大利面、糖）、精制小麦面粉 — 会在回复中说明其所属类别。

search_foods

将名称解析为 slug，并支持印地语、梵语和植物学别名。根据通用英语名称或本地名称返回排序后的候选项。

参数	类型
query	string	必填
kind	food | herb | any	可选，默认值为 any
limit	integer	可选，范围为 1–50，默认值为 10

nutrient_ranking

按每 100 g 的营养素含量对食物排序 — 回答“哪种食物含铁量最高”之类的问题。每行还会列出 heathy.org 收录的该食物典型份量及其中的营养素含量；排序依据是每 100 g 的含量。

每次只吃几克的食物 — 干香草、香料、茶叶，以及干海藻、蘑菇和蔬菜，共 102 种 — 不会列入 results。这些食物会列在旁边的 also_higher.small_amounts 中：显示每 100 g 含量高于最后一项的食物数量，以及前五种。当 include_small_amounts 为 true，或查询的类别主要由这类食物组成（spice、tea、seaweed）时，它们会列入 results。

参数	类型
nutrient	string	必填 — slug 或名称
limit	integer	可选，范围为 1–100，默认值为 20
category	string	可选 — 例如 fruit、legume、millet
min_sources	integer	可选，默认值为 1 — 食物被纳入排序所需的最少来源数；低于该数量的食物会列在 also_higher.fewer_sources 中
include_small_amounts	boolean	可选，默认值为 false — 将香料、茶和干海藻与其他所有食物一同排序

herb_monograph

阿育吠陀草药专论。传统用途与现代研究严格分开 — traditional 记录传统说法，modern 记录研究结论及其证据等级。每条回复都必须包含 safety 区块（注意事项、妊娠指导、药物相互作用）。

参数	类型
herb	string	必填 — 英语、梵语、印地语或植物学名称

check_claim

对于未经加工的完整食物或未强化的单一成分面粉，根据 GB/EU 规则（Reg. 1924/2006，每 100 g）和 US 规则（21 CFR 101.54，每 RACC），数据支持哪些营养声称（“钾来源”“富含维生素 C”）。该工具会标出答案取决于所用国家数据库的情况，并列出支持和不支持该声称的数据库。

参数	类型
food	string	必填 — slug 或名称
nutrient	string	可选 — 仅检查一种营养素
market	uk | us | both	可选，默认值为 both
only_permitted	boolean	可选 — 仅返回受支持的声称
preparation	raw	可选，且仅接受此值

范围。 这是筛查工具，并不代表获准作出声称。该工具拒绝处理熟制和加工产品，因为其成分取决于配方和加工过程。即使某项声称得到支持，仍需分析生产者自己的产品：法律考量的是最终产品，而非参考数据库。工具会列出支持和不支持某项声称的数据库；不会自行选定符合条件的数据库。

search_recipes

通过自由文本、健康目标、类别、食材、时间或过敏原，在 Heathy 上查找原创生食／免烹饪纯素食谱。每份营养数据根据 lookup_food 返回的相同食物条目计算。

参数	类型
query	string	可选 — 自由文本，例如 breakfast
goal	string	可选 — 例如 immune、bone、gut、heart
category	string	可选 — 例如 smoothies、salads、chutneys
ingredient	string	可选 — 必须包含的食物 slug 或名称
max_time	integer	可选 — 总分钟数
exclude_allergens	string[]	可选 — 例如 ["tree-nuts","sesame"]
limit	integer	可选，1–50，默认值为 10

get_recipe

获取一份完整食谱：含食物 slug 和克数的食材、做法、每份营养数据、过敏原及碳足迹。

参数	类型
recipe	string	必填 — slug 或名称

health_topic

了解针对某个健康目标该吃什么——涉及哪些营养素、各自的作用，以及哪些生食食谱含有这些营养素。可接受健康目标（“肠道健康”）或具体病症名称（“PCOS”“贫血”）。对于人们确诊后常查阅的主题，工具会附上说明，指出证据支持和不支持的内容，并单独给出证据评级。省略 topic 可列出所有主题。

参数	类型
topic	string	可选 — 目标 slug 或标题，或病症名称
include_recipes	boolean	可选，默认值为 true

示例

调用	结果
search_foods("karela")	gourd-karela-raw
lookup_food("guava", ["vitamin-c"])	222 mg · 13 个数据库的中位数 · 范围 68–273
lookup_food("besan", ["protein"])	chickpea-flour · 22.39 g · 3 个数据库
lookup_food("lentils boiled")	已拒绝 — 名称为 lentil-whole-brown，按未制备状态收录
nutrient_ranking("iron", category: "legume", min_sources: 3)	棕色扁豆 8 mg · 白大豆 7.91 mg · 鹰嘴豆 5.4 mg
nutrient_ranking("magnesium")	去壳大麻籽以 591.5 mg（每 30 g 为 177.4 mg）居首 · 另列出 37 种通常一次只吃几克的食物，其中干海莴苣以 3,200 mg 领衔
check_claim("banana", nutrient: "potassium")	GB/EU“来源”声称得到支持，含量为 335 mg——21 个数据库中，16 个支持，5 个不支持
health_topic("anaemia")	iron-deficiency-anaemia — 营养素、原因、食谱
herb_monograph("haldi")	姜黄 — 传统用途、研究、安全性

响应结构

每个工具都返回相同的封装结构：

{
  "data":        { /* the payload */ },
  "attribution": ["USDA FoodData Central …", "IFCT 2017, ICMR–NIN …"],
  "source_url":  "https://heathy.org/food/guava-flesh-only-raw/",
  "disclaimer":  "Informational only — not medical advice.",
  "license":     "https://heathy.org/terms/"
}

每个响应都包含 attribution、disclaimer 和 source_url；草药响应还包含 safety 区块，其中列有注意事项、妊娠指导和药物相互作用。https://heathy.org/terms/ 中的条款要求，您重新发布数据时注明出处。

数据来源

美洲 — USDA FoodData Central（Foundation Foods 和 SR Legacy）· Canadian Nutrient File · TACO（巴西）· INCMNSZ（墨西哥）· ARGENFOODS（阿根廷）

欧洲 — UK CoFID · ANSES-Ciqual（法国）· BLS（德国）· Frida（丹麦）· Matvaretabellen（挪威）· Livsmedelsverket（瑞典）· Fineli（芬兰）· NEVO （荷兰）· CREA（意大利）· Swiss FCDB · NutriData（爱沙尼亚）

亚洲 — IFCT 2017（ICMR–NIN，印度） · MEXT（日本）· China CFCT · Korea MFDS · Singapore SG FoodID · Pakistan FCT · Sri Lanka FCT

非洲和大洋洲 — FAO/INFOODS WAFCT（西非）· Kenya KFCT · Ethiopia EFCT · Australia AFCD（FSANZ）· Pacific Nutrient Database

全球 — FAO/INFOODS BioFoodComp · 用于国家数据库未涵盖食品的开放许可（CC BY）研究论文 · Phenol-Explorer（多酚含量，仅展示，不纳入平均值）

完整鸣谢及许可条款：https://heathy.org/sources/

许可和条款

本仓库中的文件（文档、清单和 Dockerfile）采用 MIT 许可证 发布。该许可证仅适用于本仓库。成分数据来自上述已发表的数据库，各自适用其条款，并在每次响应及上述链接中注明来源。数据整合、食谱、草药专论和原创内容版权归 Heathy 所有 — 详见 https://heathy.org/terms/。使用托管服务 mcp.heathy.org 受这些条款约束。

不构成医疗建议。 这些数据仅供参考，不能用于诊断或治疗任何疾病。100% 生食纯素饮食无法提供足量的维生素 B12 或维生素 D。