Recall Kitchen

rk-mcp

用于 Recall Kitchen MCP 的 Go 客户端和示例。

Recall Kitchen 可搜索美国 CPSC、FDA 食品、FDA MedWatch、USDA 和 NHTSA 的车辆召回信息。

托管 MCP

公共可流式传输 HTTP：https://app.recallkitchen.com/mcp。客户端配置：.mcp.json。文档：recallkitchen.com/docs。

• 使用 API 密钥免费 — 通过 MCP signup 或 Integrations 创建密钥。发送 X-API-Key: rk_...（Grok 必须使用）或 Authorization: Bearer rk_...（Claude/Cursor）。环境变量占位符：RECALL_KITCHEN_API_KEY。
• 匿名 x402 — 在 Base 上使用 USDC，每次调用 $0.025，无需注册。
• 账户工具（监控、库存、通知）需要密钥。
• 速率限制 — 未验证时约为每小时 60 次工具调用；在 app.recallkitchen.com 验证登录后约为每小时 600 次。

本地地址：http://localhost:8080/mcp。服务卡片：https://app.recallkitchen.com/.well-known/mcp/server-card.json。

工具参考：recallkitchen.com/docs/#mcp。实现说明：docs/mcp.md。

身份验证

调用工具有两种方式：

1. API 密钥（推荐） — 免费，速率限制更高。在应用的 Integrations 中创建密钥。发送 X-API-Key: rk_...（Grok 必须使用）或 Authorization: Bearer rk_...（Claude Code、Cursor）。
2. x402 — 在 Base 上匿名使用 USDC（约 $0.025 / 次调用）。设置 X402_EVM_PRIVATE_KEY。监控、库存和通知工具仍需要 API 密钥。

Grok 的 HTTP MCP 客户端会将 Authorization: Bearer 视为 OAuth。Grok 请使用 X-API-Key。

# ~/.grok/config.toml
[mcp_servers.recall-kitchen]
url = "https://app.recallkitchen.com/mcp"
enabled = true

[mcp_servers.recall-kitchen.headers]
X-API-Key = "rk_..."

export RK_API_KEY=rk_...

工具

公开工具（API 密钥或 x402）

工具	用途
search_product_recalls	按关键词搜索。可选参数：source、since/until（YYYY-MM-DD）、location、offset、limit（1–100，默认值为 3）。
search_recalls_by_identifier	精确搜索 UPC、产品名称或车辆品牌和型号。
search_product_recalls_by_upc	查询 UPC，并匹配提取出的召回 UPC。未知时返回 found=false。
lookup_product	查询目录 / USDA 品牌食品信息。不搜索召回信息。
search_product_recalls_from_image	按照片搜索（测试版）。支持公开 HTTPS URL、data:image/...;base64 URI 或 MCP 图像内容。不支持本地文件路径。
get_product_recall	获取完整描述、公告中列出的批次代码、UPC、型号、地点、联系方式和图片 URL。

搜索结果中的描述会被截断，提取的产品数量最多为 5。调用 get_product_recall 可获取完整公告。

location 会与查询条件取交集。CA 可匹配 California / “northern california”。United States 匹配美国公告，不匹配 Canada/Ontario。

账户工具（需要 API 密钥）

list_watch_patterns、add_watch_pattern、remove_watch_pattern、list_inventory、add_inventory_product、remove_inventory_product、check_tracked_products、list_recall_notifications。

监控模式使用与搜索框相同的语法：单词之间为 AND，OR 表示或，-term 表示排除，"quoted phrase" 表示短语。

提示词：check_product、check_upc、scan_image（照片，测试版）、list_vin_campaigns（按车型年份和品牌列出 NHTSA 活动；不检查特定车辆）。资源：recall://docs/tools、recall://docs/sources。

Go 客户端

cc, err := rkmcp.NewClient(rkmcp.Config{
    ServerURL: "https://app.recallkitchen.com/mcp",
    APIKey:    os.Getenv("RK_API_KEY"),
})
recalls, err := cc.SearchProductRecalls(ctx, "contamination", 3)
detail, err := cc.GetProductRecall(ctx, recalls[0].ID)
hits, err := cc.SearchRecallsByIdentifier(ctx, rkmcp.IdentifierOptions{UPC: "012345678905"})

APIKey 也会从 RK_API_KEY 或 RECALL_KITCHEN_API_KEY 读取。客户端会发送 X-API-Key。匿名客户端也可以改为设置 EVMPrivateKey / X402_EVM_PRIVATE_KEY。

模块：github.com/Recall-Kitchen/rk-mcp/go。

Examples

git clone https://github.com/Recall-Kitchen/rk-mcp.git
cd rk-mcp/examples/go
export RK_API_KEY=rk_...
go run ./search_product_recalls -query "spinach" -location Iowa
go run ./get_product_recall            # searches, then fetches full text
go run ./search_by_identifier -name "infant formula"

See examples/go.

Other clients

• Grok: X-API-Key header (see above).
• Claude Code: claude mcp add --transport http recall-kitchen https://app.recallkitchen.com/mcp --header "Authorization: Bearer ${RK_API_KEY}"
• Cursor: copy .mcp.json (X-API-Key + RECALL_KITCHEN_API_KEY). Authorization: Bearer also works.

Support

[email protected]