io.github.wyre-technology/iqms-mcp

Official

by wyre-technology · TypeScript

IQMS / DELMIA Apriso

MCP server for IQMS (DELMIAworks) ERP — manufacturing, inventory, production, and quality.

MCP server for IQMS ERP—manage manufacturing, inventory, production, and quality.

Topics

delmiaworksenterpriseiqerpiqmsmanufacturingmcpmodel-context-protocolmsporacle

README.md3 KBView on GitHub

`iqms-mcp`

MCP server for IQMS / DELMIAworks (EnterpriseIQ), the manufacturing ERP from Dassault Systèmes.

Status: Scaffolding. Read tools issue queries through @wyre-technology/node-iqms, which has tentative SQL pending design-partner schema validation. Write tools route through the licensed DELMIAworks WebAPI module and currently throw NotImplementedError until vendor SDK access.

Why this exists

EnterpriseIQ doesn't have a public REST API. The realistic integration paths are:

Direct Oracle (universal at every install) — read-only queries
WebAPI module (paid licensed add-on) — transactional writes

This MCP server exposes both behind a single decision-tree-navigated tool surface.

Tools

Initial discovery surface (always available):

iqms_navigate — list tools in a domain
iqms_status — credential / connection check

Domains: workorders, inventory, boms, sales_orders, purchase_orders, schedule, quality.

Read tools (Oracle, available always):

Tool	Purpose
`iqms_workorders_list`	Open / in-progress work orders
`iqms_workorders_get`	Full work order detail incl. routings
`iqms_inventory_onhand`	On-hand by item / location / lot
`iqms_inventory_lot_trace`	Lot genealogy walk
`iqms_boms_explode`	BOM explosion
`iqms_boms_where_used`	Where-used reverse lookup
`iqms_sales_orders_list`	Open SOs / ship status
`iqms_purchase_orders_list`	Open POs / expected receipts
`iqms_schedule_capacity`	Machine schedule + capacity load
`iqms_quality_ncrs`	Non-conformances / CARs / CAPAs

Write tools (WebAPI, gated):

Tool	Purpose
`iqms_workorders_create`	Create a new work order
`iqms_workorders_post_production`	Post qty made / scrapped
`iqms_inventory_adjust`	Inventory transaction
`iqms_quality_create_ncr`	Open a non-conformance record

Run modes

Local (stdio)

bash

IQMS_ORACLE_USER=eiq_ro \
IQMS_ORACLE_PASSWORD=… \
IQMS_ORACLE_CONNECT_STRING=eiq-db.example.com:1521/EIQ \
npx -y github:wyre-technology/iqms-mcp

Gateway (HTTP, stateless)

bash

MCP_TRANSPORT=http \
MCP_HTTP_PORT=8080 \
AUTH_MODE=gateway \
node dist/http.js

In gateway mode, credentials are injected per-request via headers:

Header	Required	Notes
`X-IQMS-Oracle-User`	yes	Oracle DB user
`X-IQMS-Oracle-Password`	yes	Oracle DB password
`X-IQMS-Oracle-Connect-String`	yes	Easy Connect or TNS
`X-IQMS-WebAPI-Base-URL`	no	Enables write tools when present
`X-IQMS-WebAPI-User`	no
`X-IQMS-WebAPI-Password`	no

License

Apache-2.0

Install

Configuration

Environment variables

IQMS_ORACLE_CONNECT_STRINGrequired

Oracle connection string for the IQMS database (e.g. host:port/service)

IQMS_ORACLE_USERrequired

IQMS Oracle DB username

IQMS_ORACLE_PASSWORDrequiredsecret

IQMS Oracle DB password

MCP_TRANSPORTdefault stdio

Transport mode for the server. Set to 'stdio' for local CLI use; the image defaults to 'http' for gateway hosting.

AUTH_MODEdefault env

Credential source: 'env' reads vars locally, 'gateway' expects header injection from the WYRE MCP Gateway.

LOG_LEVELdefault info

Log verbosity: debug, info, warn, error

claude_desktop_config.json

{
  "mcpServers": {
    "iqms-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/wyre-technology/iqms-mcp:v1.2.7"
      ],
      "env": {
        "IQMS_ORACLE_CONNECT_STRING": "<YOUR_IQMS_ORACLE_CONNECT_STRING>",
        "IQMS_ORACLE_USER": "<YOUR_IQMS_ORACLE_USER>",
        "IQMS_ORACLE_PASSWORD": "<YOUR_IQMS_ORACLE_PASSWORD>",
        "MCP_TRANSPORT": "stdio",
        "AUTH_MODE": "env",
        "LOG_LEVEL": "info"
      }
    }
  }
}