Skip to content
Engineering Decision Intelligence
Documentation menu
How-toVersion 0.4.1

Install openLCA MCP

Install the MCP server, configure openLCA, start the process, and verify the first connection.

Requirements

  • Python 3.11 or newer
  • openLCA Desktop 2.x
  • The intended database open in openLCA
  • The openLCA IPC server running

Install from source

bash
git clone https://github.com/SDAI-institute/openlca-mcp.git
cd openlca-mcp
pip install -e .

For development dependencies:

bash
pip install -e ".[dev]"

Configure openLCA

  1. Open the database you want to use.
  2. Go to Tools → Developer Tools → IPC Server.
  3. Start the server, normally on port 8080.
  4. Keep the IPC server running.
text
OPENLCA_HOST=localhost
OPENLCA_PORT=8080
OPENLCA_READ_ONLY=true
LOG_LEVEL=INFO

Start the MCP server

bash
python -m src

You can also use the installed console script:

bash
openlca-mcp

Note

Do not launch python -m src.app. The package entry point is python -m src.

Verify the connection

Use test_connection or health_check as the first MCP call. Then confirm the active database before running study calculations.