ANSES Ciqual

MCP for Anses Ciqual French food composition and nutritional database

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": {
    "zzgael-ciqual-mcp": {
      "command": "uvx",
      "args": [
        "ciqual-mcp"
      ],
      "env": {
        "YOUR_TOKEN": "YOUR_TOKEN"
      }
    }
  }
}

You can run the ANSES Ciqual MCP Server to access the Ciqual French food composition data via a programmable, read-only SQL interface. This server starts locally, updates its data yearly on startup, and serves a compact SQLite database that you can query with standard SQL from your MCP clients.

How to use

You interact with the Ciqual MCP Server through a client that speaks the MCP protocol. Start the server locally and point your client to its local runtime. Use your client to submit SELECT queries that join foods, nutrients, and composition data to retrieve nutrition information for thousands of foods. You can leverage full-text search for flexible name matching and perform common SQL operations like JOIN, GROUP BY, and ORDER BY to explore nutrients across foods.

How to install

Prerequisites you need before installing:

Python 3.9 or higher
Internet access for initial data download
A shell environment (bash, PowerShell, etc.)

# Option 1: Install from PyPI (simple and quick)
pip install ciqual-mcp

# Option 2: Run with the MCP runtime (recommended for runtime isolation)
uvx ciqual-mcp

# Option 3: Install from source
git clone https://github.com/zzgael/ciqual-mcp.git
cd ciqual-mcp
pip install -e .

Configuration for MCP clients

To connect an MCP client, configure it to run the local Ciqual MCP server. The practical, supported runtime is the MCP client that launches the server process.

{
  "mcpServers": {
    "ciqual": {
      "command": "uvx",
      "args": ["ciqual-mcp"]
    }
  }
}

Available tools

query

MCP function that executes SQL queries against the Ciqual database. Returns a list of row dictionaries or an error object. Read-only and supports standard SQLite syntax, including joins and full-text search via the foods_fts table.