Allergen Detector

Allergen Detector MCP

Allergen Detector 匹配引擎作为 MCP 服务运行，让 AI 助手和购物 Agent（ChatGPT、Claude 等）在推荐或购买商品前，能够根据家庭成员的过敏情况检查商品。

它使用与 Chrome 扩展相同的 matcher.js 和过敏原映射表（51 种过敏原、1,078 个名称）。映射表每天从 GitHub 刷新，因此映射表更新后，Agent 无需重新部署即可获取更新。

工具

工具	功能
check_product_allergens	根据一个或多个人的过敏原（含严重程度）检查成分表，并返回哪些人受影响、受哪种成分影响，以及原因。“不含……”声明不会掩盖实际成分。
lookup_ingredient	告知某个成分名称属于哪种过敏原（“sodium caseinate” → 牛奶）。
list_supported_allergens	列出该服务涵盖的过敏原。

对于不使用 MCP 的 Agent，同样的检查也可通过普通 Web API 使用：POST /api/check、POST /api/lookup 和 GET /api/allergens，详情见 /openapi.json。

API 密钥为可选项。 在主机上设置 API_KEYS="muse=<key>,acme=<key>"，即可为每个合作方配置独立密钥，通过 X-API-Key 或 Authorization: Bearer 发送。未提供密钥的请求仍可使用；密钥错误时返回 401。有效密钥会在 /stats 中标识合作方。

所有工具均为只读且无状态。不会存储或记录任何个人信息（过敏原、成分）。唯一的日志是每天的匿名工具调用次数，用于衡量使用情况。

运行

npm install
npm test           # end-to-end test over MCP
npm start          # remote server: http://localhost:3000/mcp
npm run stdio      # local server for Claude Desktop and similar
npm run sync       # copy the latest matcher.js and map from the extension

若要在 Claude Desktop 中本地使用，请将以下内容添加到其配置的 mcpServers 部分：

"allergen-detector": { "command": "node", "args": ["/path/to/allergen-mcp/server.js", "--stdio"] }

发布步骤

1. 托管服务，并提供公开的 HTTPS URL。Render 或 Fly.io 可以从 GitHub 仓库运行 npm start，每月费用为 $0–7。之后，将 mcp.safi.ai 指向该服务。
2. 隐私政策和条款页面。 每个目录都要求提供这些内容。safi.ai 上线前，可将页面托管在 GitHub Pages。核心内容是：不会存储健康数据。
3. 在官方 MCP Registry 中上架（registry.modelcontextprotocol.io），使用 mcp-publisher CLI，并将其列在 io.github.daniellemeng1022/allergen-detector 名下。许多客户端和目录会从该注册表获取信息。
4. 提交到社区目录： Smithery、Glama、PulseMCP 和 mcp.so。
5. Claude： 任何人现在都可以粘贴 URL，将其添加为自定义连接器。若要出现在 Anthropic 的连接器目录中，请通过其目录表单提交。
6. ChatGPT： 先在开发者模式下测试，然后通过 OpenAI 的 Apps SDK 提交流程将其作为应用提交。此操作需要经过验证的开发者账号。
7. Meta Muse（优先处理）： 在 muse.ai/platform 提交。选择“Existing MCP”，输入托管的 URL，选择“API keys”，并提供一个来自 API_KEYS 的 Meta 专用密钥（例如 muse=…），这样其调用会在 /stats 中显示为 muse，并将付款选项设为“no”，然后描述该服务。Meta 会测试线上端点，因此必须先完成第 1 步。Muse 已支持在 Sephora、Walmart、Best Buy 和 Shopify 商品目录中购物，涵盖我们的两个品类（化妆品和食品）。
8. Instinct 及类似助手： Instinct 未说明是否支持自定义 MCP。它通过 Shopify 和 Shop Pay 购物。建议联系对方洽谈合作。
9. 购物 Agent： 联系正在开发 Agent 商务产品的团队，并在试点期间免费提供该端点。
10. 衡量使用情况： 在主机上设置 STATS_KEY，然后打开 https://<your-url>/stats?key=<STATS_KEY>，查看按日期、Agent 和工具统计的调用次数。connect 计数表示 Agent 已连接；工具计数表示实际检查次数。服务器重启时，/stats 会重置，但每个计数也会以 [usage] JSON 行的形式保存在主机日志中。按周跟踪检查次数和不同 Agent 的数量。

扩大规模前

• 为高频业务用户添加速率限制和 API 密钥。保留免费套餐。
• 在每条响应中保留免责声明。不要将结果作为医疗建议。