内容
# 斯瑟恩 MCP
**美国包装食品的产品评估MCP服务器**。给你的代理一个条形码,并获得一个确定的、有引用的判决。健康评分、成分级安全、国家监管标志、FDA召回历史和企业所有权解析到最终母公司。
托管,远程,无需安装,无需身份验证。
```
https://api.scern.app/mcp
```
将该URL粘贴到Claude或任何支持Streamable HTTP的MCP客户端,并开始评估产品。
## 在Claude中实时运行
Claude工件可以直接调用MCP连接器。这是Scern在Claude工件中启用实时评估和比较交换流程的示例,无需编写集成代码。


## 为什么存在
代理开始购买杂货。当有人告诉他们的代理“本周为我的孩子订购零食”,代理必须将模糊的请求转换为特定的产品。是什么为该选择提供了参考?目前,答案大多是搜索结果中排名第一的内容。
Scern是该决策的评估层。同样的条形码输入,相同的结构化判决输出,每次都是如此。代理可以比较选项并解释其选择。
## 工具
### `evaluate_product`
通过条形码评估单个产品。
| 参数 | 类型 | 必需 | 描述 |
|---|---|---|---|
| `identifier` | `"upc"` \| `"ean"` \| `"barcode"` | 是 | 条形码标识符类型 |
| `value` | 字符串 | 是 | 条形码值 |
| `jurisdiction` | 字符串或字符串数组 | 否 | 过滤监管标志。有效值为 `CA`、`TX`、`WV` |
| `context` | `"retail"` \| `"school_meals"` | 否 | 评估上下文,默认为 `retail` |
返回完整的评估。健康评分采用Nutri-Score 2023字母等级,根据制造商面板数据计算,NOVA加工分类,逐成分安全审查并附有通俗易懂的解释,国家监管标志均附带法律、生效日期、处罚和来源URL,FDA召回历史,包装政策数据,以及解析为最终母公司的品牌所有权链。
当底层数据不足以诚实评分时,API将返回 `insufficient_data` 而不是猜测。
### `compare_products`
比较2到5个产品的健康评分。返回所有评估、按健康评分降序排列的排名以及得分最高的条形码。未找到的产品将作为 `{ value, status: "not_found" }` 包含,并排除在排名之外。
| 参数 | 类型 | 必需 | 描述 |
|---|---|---|---|
| `values` | 字符串数组 | 是 | 2到5个条形码值 |
| `identifier` | `"upc"` \| `"ean"` \| `"barcode"` | 否 | 应用于所有值,默认为 `upc` |
| `jurisdiction` | 字符串或字符串数组 | 否 | 过滤监管标志。有效值为 `CA`、`TX`、`WV` |
| `context` | `"retail"` \| `"school_meals"` | 否 | 评估上下文,默认为 `retail` |
这是交换流程。代理对搜索结果中的候选产品进行评分,提出更好的评分替代方案,并可以解释原因。“这个产品有红40标志,这个替代方案评分更高,没有标志,要交换吗?”
## 评估结果示例
评估Pop-Tarts条形码的真实摘录:
```json
{
"name": "Frosted Strawberry Pop-Tarts",
"brand": "Pop-Tarts",
"healthScore": 29,
"scoreLabel": "Caution",
"score_basis": "nutrition_derived",
"healthBreakdown": { "nutriScoreGrade": "e", "novaGroup": 4 },
"matchStats": { "total": 26, "matched": 26, "matchRate": 1 },
"regulatory_flags": [
{
"jurisdiction": "TX",
"law_name": "Make Texas Healthy Again Act (SB 25)",
"status": "warning_label_required",
"effective_date": "2027-01-01",
"ingredient_found": "red 40",
"penalty": "Up to $50,000 per day per violative product",
"source_url": "https://capitol.texas.gov/BillLookup/History.aspx?LegSess=89R&Bill=SB25"
}
],
"brandOwnershipChain": {
"ownershipPath": ["Pop-Tarts", "Kellanova", "Mars, Incorporated"]
}
}
```
产品中的每个成分都获得其自己的审查条目。红40、黄6、蓝1和TBHQ均在此产品上触发德克萨斯州SB 25标志,并附有引用的法规。
## 连接
**Claude(网页或桌面版)**。设置,连接器,添加自定义连接器,粘贴 `https://api.scern.app/mcp`。
**Claude 代码**。
```
claude mcp add --transport http scern https://api.scern.app/mcp
```
**任何仅支持STDIO的客户端**,通过 [mcp-remote](https://www.npmjs.com/package/mcp-remote):
```json
{
"mcpServers": {
"scern": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://api.scern.app/mcp"]
}
}
}
```
**纯HTTP**。服务器支持Streamable HTTP JSON-RPC。`initialize`后跟`tools/list`可从curl工作,如果您想直接检查模式。`POST https://api.scern.app/v1/products/evaluate` 处也有一个REST端点,接受 `{"identifier": "upc", "value": "..."}`。
## 背后技术
- 涵盖约90%美国包装食品的、人工审查的成分词典,每个词条都带有审查状态和通俗易懂的解释
- 根据制造商营养面板数据计算的Nutri-Score 2023评分,并在有效载荷中提供字母等级
- 加利福尼亚州AB 418、德克萨斯州SB 25、德克萨斯州SB 314和西弗吉尼亚州HB 2354的监管标志跟踪,支持管辖区过滤和学校膳食环境
- 通过openFDA检查的FDA召回历史,在每次评估时检查并缓存
- 解析为最终母公司的企业所有权树,通过最近的收购更新
- 包括FCCdb化学数据的包装政策索引(如果可用)
确定性是设计约束。数据库和判决之间没有生成模型。相同的条形码返回相同的评估,直到底层数据发生变化,负载中的每个声明都带有其出处。
## 覆盖范围和诚实度
Scern涵盖美国包装食品,重点关注营销给儿童和家庭的产品。覆盖范围正在扩大。当产品未知或其数据过于薄弱,无法评分时,API会说明,如“未找到”和“数据不足”是您会看到的真实答案。如果您遇到影响您正在构建的内容的覆盖范围缺口,请提出问题。缺口报告直接影响下一步添加的内容。
## 反馈
问题和讨论是开放的。如果您正在构建涉及食品、杂货、营养或购物的代理,我非常乐意听到您的反馈,哪些有效,哪些无效。
由Cory Lewis构建。联系邮箱:cory@scern.app。