食品数据库API服务

openfoodfacts mcp

MCP服务器 开放食品事实 API-搜索、阅读并为世界上最大的开放式食品数据库做出贡献。

用例

按名称查找产品：“塞恩斯伯里水牛鸡肉卷含有多少卡路里？”->按名称搜索，找到产品，并返回营养数据。

通过条形码查找产品：“条形码为3017620422003的产品中有什么？”->获取Nutella的成分、营养评分和营养数据。

寻找健康的选择：“搜索营养评分为A的早餐谷物”->使用类别和营养等级过滤器进行搜索。

贡献数据：“为条形码12345678添加产品名称和品牌”->在Open Food Facts上创建或更新产品条目。

探索数据库：“数据库中有哪些品牌的有机巧克力？”->使用自动补全和搜索进行探索。

设置

按照以下说明操作 安装mcp，它为您的MCP客户端生成正确的配置（Claude Code、Claude Desktop、Cursor、Cline、VS Code等）。

集 OFF_USER_AGENT 识别您的应用程序（例如。 openfoodfacts-mcp/1.2.0 (you@example.com)).对于写入操作（添加/编辑产品、上传图像），还设置 OFF_USER_ID 和 OFF_PASSWORD.

环境变量

变量	必填	描述
OFF_USER_AGENT	Yes	用户代理字符串，例如。 "AppName/1.0 (email@example.com)"
OFF_USER_ID	否	Open Food Facts用户名（用于写入操作）
OFF_PASSWORD	否	Open Food Facts密码（用于写入操作）
OFF_COUNTRY	否	国家子域（默认值： world)

工具

工具	描述	身份验证
get_product	通过条形码获取产品信息	否
search_products_standard	使用结构化过滤器（品牌、类别、营养评分）搜索	否
search_products_lucene	使用Lucene语法、否定和布尔逻辑进行搜索	否
autocomplete	自动完成品牌、类别、标签等。	没有
add_or_edit_product	添加或更新产品	是
upload_image	上传产品图片	是
select_image	选择、裁剪和旋转图像	是
call_api	直接调用任何OFF API端点	取决于
get_api_docs	退出API文档	否

贡献

GitHub上欢迎拉取请求！开始：

1. 安装Git和Node.js
2. 克隆仓库
3. 安装依赖项 npm install
4. 跑 npm run test 运行测试
5. 建立 npm run build

发布

版本遵循 语义版本规范.

要发布：

1. 使用 npm version <major | minor | patch> 升级版本
2. 跑 git push --follow-tags 使用标签推送
3. 等待GitHub Actions发布到NPM注册表。