Connect an MCP client to BioSTEAM / QSDsan MCP

Configure a local stdio client or a protected HTTP endpoint.

Connect over local stdio

Install the server in the intended BioSTEAM/QSDsan environment. Keep the working directory at the MCP directory so the server package and sibling engine module resolve from the same source tree.

json

{
  "mcpServers": {
    "biosteam": {
      "command": "python",
      "args": ["-m", "src"],
      "cwd": "/absolute/path/to/Biosteam/mcp",
      "env": {
        "TRANSPORT": "stdio",
        "BIOSTEAM_MCP_READONLY": "true"
      }
    }
  }
}

Verify the connection

text

health_check
→ list_biorefinery_models

Then choose build_system, build_system_from_spec, or build_sanitation_system according to the process model you need.

Use read-only mode

text

BIOSTEAM_MCP_READONLY=true

This blocks model construction, re-simulation, uncertainty runs, optimization, job mutation, and result disposal while allowing inspection of existing stored results.

Use local HTTP

bash

TRANSPORT=http MCP_HOST=127.0.0.1 MCP_PORT=8000 python -m src

Keep the raw runtime private. For remote clients, use an authenticated gateway, VPN, or secure tunnel.