OpenFoodTox

MCP server providing tools to access EFSA's comprehensive OpenFoodTox Chemical Hazards in food dataset

python

5

GitHub Stars

python

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

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

You can query EFSA’s OpenFoodTox chemical hazards data through a dedicated MCP server that makes substance safety data, toxicity endpoints, risk assessments, and EFSA opinions accessible via natural language prompts. This enables scientists, regulators, manufacturers, and public health professionals to quickly obtain validated hazard information and context for food-related substances.

How to use

Connect to the MCP server using your preferred MCP client. You can ask questions in natural language to retrieve specific information about substances, their safety assessments, toxicity endpoints, risk assessments (ADI/TDI), genotoxicity details, and EFSA opinions.

Example usage patterns you can perform after connecting: - Find a substance by name, E-number, or description. - Check if a substance is considered mutagenic, genotoxic, or carcinogenic. - Retrieve NOAEL, LD50, and target organs from toxicity studies. - Query safe daily intake limits (ADI/TDI) and safety factors. - Retrieve EFSA opinions with publication dates, DOIs, and regulatory information. - Filter substances by class (food additive, pesticide, etc.) or by specific risk assessment criteria.

If you need more structured data, you can request detailed genotoxicity study information or export lists of substances that meet particular safety criteria. Always use precise substance identifiers in your queries to minimize ambiguity.

How to install

Prerequisites you need before running the MCP server:\n- Python 3.12 or newer\n- uv package manager\n- Internet access for initial setup and data loading

Step 1 — Set up the environment and dependencies\nRun the setup to create a virtual environment, install dependencies, and initialize the database for first run.

make setup

Step 2 — Install the MCP server in Claude Desktop (optional)\nYou can automate the installation with the following command.

make claude

If you prefer to configure manually in Claude Desktop, add the MCP server configuration under Local MCP servers with the following structure. Replace the paths with your actual project paths.

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

Additional notes

Configuration is driven by a Python-based MCP server that leverages the latest EFSA OpenFoodTox dataset (latest update as of 14 September 2023). The server provides tools for substance search, safety assessments, toxicity data, risk assessments, genotoxicity details, opinions, and classification queries.

Prerequisite installation details include obtaining the uv tool and Python 3.12+. The installation flow emphasizes a self-contained setup via a virtual environment and local runtime, with the option to run through Claude Desktop for convenience.

Available tools

Search Substance

Find substances by name, E-number, or description through natural language prompts.

Get Substance Safety Assessment

Query safety flags such as mutagenic, genotoxic, or carcinogenic for a given substance.

Get Toxicity Endpoints

Retrieve toxicity study data including NOAEL, LD50, and target organs.

Get Risk Assessments

Obtain safe intake limits (ADI/TDI) and associated safety factors for substances.

Get Genotoxicity Details

Access detailed genotoxicity study information including test guidelines and results.

Get Opinions

Retrieve EFSA opinion documents with publication dates, DOIs, and regulation information.

List Substances by Class and Safety

Filter substances by category (e.g., food additive, pesticide) and safety criteria.

List Substances by Assessment

Find substances matching risk assessment criteria such as ADI/TDI ranges.