🧪 MCP OpenFoodTox

🧪 MCP OpenFoodTox

Accessing EFSA's Chemical Hazards Database using natural language

使用自然语言访问 EFSA 的化学危害数据库

A Model Context Protocol (MCP) providing access to EFSA's comprehensive OpenFoodTox database containing 8,006 chemical substances, 45,582 alternative names, and 54,621 study records from 2,437 scientific assessments across 8 interconnected data tables with over 138,000 entries.

一个模型上下文协议（MCP），提供对 EFSA 全面的 OpenFoodTox 数据库的访问，该数据库包含 8,006 种化学物质、45,582 个别名和来自 2,437 项科学评估的 54,621 条研究记录，分布在 8 个相互关联的数据表中，共有超过 138,000 条条目。

This OpenFoodTox MCP server uses the latest EFSA dataset (updated 14 September 2023) (OpenFoodTox, data report, Zenodo) and addresses the critical need for accessible chemical safety data by consolidating EFSA's authoritative risk assessments of regulated food products, contaminants, pesticides, and feed additives. Unlike hard to use toxicological databases and spreadsheets scattered across various sources, OpenFoodTox provides structured hazard characterization data—including 11,357 risk assessments (ADI/TDI values), 11,698 toxicity endpoints (NOAEL, LD50), and 246 genotoxicity studies. This MCP makes EFSA's scientifically validated safety assessments readily available through natural language queries (via a large language model such as Claude Deesktop) for scientists, regulators, food manufacturers, and public health stakeholders.

该 OpenFoodTox MCP 服务器使用最新的 EFSA 数据集（2023 年 9 月 14 日更新）（OpenFoodTox、数据报告、Zenodo），通过整合 EFSA 对受监管食品、污染物、农药和饲料添加剂的权威风险评估，解决了对可访问化学安全数据的关键需求。与分散在各个来源中难以使用的毒理学数据库和电子表格不同，OpenFoodTox 提供结构化的危害特征数据——包括 11,357 项风险评估（ADI/TDI 值）、11,698 个毒性终点（NOAEL、LD50）和 246 项遗传毒性研究。该 MCP 通过自然语言查询（经由 Claude Desktop 等大型语言模型），使 EFSA 经科学验证的安全评估能够方便地为科学家、监管机构、食品制造商和公共卫生利益相关者所用。

🛠️ Tools

🛠️ 工具

• Search Substance - Find substances by name, E-number, or description. Answers: "What is [substance]?"
• 搜索物质 - 按名称、E 编号或描述查找物质。回答："什么是[物质]？"
• Get Substance Safety Assessment - Get safety flags (mutagenic, genotoxic, carcinogenic) for a substance. Answers: "Is [substance] safe?"
• 获取物质安全评估 - 获取物质的安全标志（致突变性、遗传毒性、致癌性）。回答："[物质]安全吗？"
• Get Toxicity Endpoints - Get toxicity study data including NOAEL, LD50, and target organs. Answers: "What are the toxicity effects of [substance]?"
• 获取毒性终点 - 获取毒性研究数据，包括 NOAEL、LD50 和靶器官。回答："[物质]的毒性效应是什么？"
• Get Risk Assessments - Get safe intake limits (ADI/TDI values) and safety factors. Answers: "How much [substance] is safe daily?"
• 获取风险评估 - 获取安全摄入限量（ADI/TDI 值）和安全系数。回答："每天摄入多少[物质]是安全的？"
• Get Genotoxicity Details - Get detailed genotoxicity study information including test guidelines and results. Answers: "Is [substance] genotoxic?"
• 获取遗传毒性详情 - 获取详细的遗传毒性研究信息，包括测试指南和结果。回答："[物质]具有遗传毒性吗？"
• Get Opinions - Retrieve EFSA opinion documents with publication dates, DOIs, and regulation information. Answers: "What EFSA opinions exist for [substance]?"
• 获取意见书 - 检索 EFSA 意见书文件，包含发布日期、DOI 和法规信息。回答："关于[物质]有哪些 EFSA 意见书？"
• List Substances by Class and Safety - Filter substances by category (food additive, pesticide, etc.) and safety criteria. Answers: "List all [category] substances" or "Show me carcinogenic food additives"
• 按类别和安全性列出物质 - 按类别（食品添加剂、农药等）和安全标准筛选物质。回答："列出所有[类别]物质"或"显示致癌的食品添加剂"
• List Substances by Assessment - Find substances matching specific risk assessment criteria (ADI/TDI ranges, assessment types, population groups). Answers: "List substances with ADI > 5 mg/kg" or "Find substances assessed for children"
• 按评估列出物质 - 查找符合特定风险评估标准（ADI/TDI 范围、评估类型、人群群体）的物质。回答："列出 ADI > 5 mg/kg 的物质"或"查找针对儿童评估的物质"

🧾 Data Attribution

🧾 数据归属

This project uses data from EFSA OpenFoodTox, the European Food Safety Authority’s chemical hazards database.
Data source:

本项目使用来自 EFSA OpenFoodTox 的数据，即欧洲食品安全局的化学危害数据库。
数据来源：

European Food Safety Authority (EFSA). OpenFoodTox – The EFSA Chemical Hazards Database. Zenodo, DOI: 10.5281/zenodo.8120114
.

欧洲食品安全局（EFSA）。OpenFoodTox – EFSA 化学危害数据库。Zenodo，DOI：10.5281/zenodo.8120114
。

© European Food Safety Authority. Licensed under Creative Commons Attribution 4.0 International (CC BY 4.0)
.

© 欧洲食品安全局。根据知识共享署名 4.0 国际许可协议（CC BY 4.0）授权
。

Official EFSA dataset page: https://www.efsa.europa.eu/en/data-report/chemical-hazards-database-openfoodtox

EFSA 官方数据集页面：https://www.efsa.europa.eu/en/data-report/chemical-hazards-database-openfoodtox

Disclaimer:
OpenFoodTox compiles toxicological reference values and hazard data extracted from EFSA’s scientific opinions.
The dataset is provided for transparency and research purposes; for regulatory or legal use, always consult the original EFSA scientific outputs.

免责声明：
OpenFoodTox 汇编了从 EFSA 科学意见书中提取的毒理学参考值和危害数据。
该数据集出于透明度和研究目的提供；用于监管或法律用途时，请始终查阅 EFSA 的原始科学成果。

📋 Requirements

📋 要求

• Python 3.12+
• Python 3.12+
• uv package manager
• uv 包管理器
• More details
• 更多详情

⚡ Quick Installation in 2 steps

⚡ 两步快速安装

1. Create virtual environment, install dependencies and setup the database (required on first run)
   创建虚拟环境、安装依赖并设置数据库（首次运行时必需）

make setup

_No virtual environment activation is required_

_无需激活虚拟环境_

1. Install MCP server in Claude Desktop (optional)
   在 Claude Desktop 中安装 MCP 服务器（可选）

# Automated installation
make claude

If you prefer to install _manually_, add to Claude Desktop user -> settings -> Developer -> Local MCP servers -> Edit Config:

如果你更倾向于_手动_安装，请在 Claude Desktop 用户 -> 设置 -> 开发者 -> 本地 MCP 服务器 -> 编辑配置中添加：

{
  "mcp-openfoodtox": {
    "command": "absolute/path/to/mcp-openfoodtox/.venv/bin/python",
    "args": ["absolute/path/to/mcp-openfoodtox/main.py"]
  }
}

The config file location:

配置文件位置：

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%/Claude/claude_desktop_config.json
• Windows： %APPDATA%/Claude/claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json
• Linux： ~/.config/Claude/claude_desktop_config.json

📦 Prerequisites Installation Details

📦 前置条件安装详情

📦 Install uv

📦 安装 uv

Mac/Linux

curl -LsSf https://astral.sh/uv/install.sh | sh

Mac/Linux

Or via HomeBrew (Mac)

brew install uv

或通过 HomeBrew（Mac）

Windows

winget install astral-sh.uv

Windows

🐍 Install Python 3.12+

🐍 安装 Python 3.12+

uv python install 3.12

📄 License

📄 许可证

This project is licensed under the MIT License - see the LICENSE file for details.

本项目根据 MIT 许可证授权 - 详情请参阅 LICENSE 文件。

©️ Copyright

©️ 版权

Copyright (c) 2025 Spyros Zevelakis, Phoebe AI Limited

版权所有 (c) 2025 Spyros Zevelakis，Phoebe AI Limited

This software is open source and available under the MIT License.

本软件为开源软件，根据 MIT 许可证提供。