elm-alm-py

MCP server for IBM Engineering Lifecycle Management (ELM) — read and write access to DOORS Next (RM), RTC/EWM (CCM), and ETM (QM) via OSLC REST APIs.

Tested against ELM 7.0.3 (alm.dataprev.gov.br).

Install

uv pip install -e .

Configuration

Option 1: Credentials file (recommended)

elm-alm-py login

Saves to ~/.elm_creds.json:

{"url": "https://your-elm-server.example.com", "username": "user", "password": "base64encoded"}

Option 2: Environment variables

export ELM_URL=https://your-elm-server.example.com
export ELM_USER=your_username
export ELM_PASSWORD=secret

Usage

# As MCP server (stdio)
elm-alm-py

MCP client configuration

{
  "mcpServers": {
    "elm-alm": {
      "command": "/path/to/.venv/bin/elm-alm-py"
    }
  }
}

Tools

Read Operations

Write Operations

create_workitem parameters

custom_fields for project-specific attributes

Some RTC projects require custom fields. Pass them as a dict:

custom_fields={
    "rtc_ext:com.dataprev.team.workitem.attribute.categoriatarefa": {
        "rdf:resource": "https://server/ccm/oslc/enumerations/{projectAreaId}/..."
    }
}

Values can be:

• {"rdf:resource": "uri"} — for URI/enumeration fields
• "text" — for literal text fields

OSLC API Details

Work Item Types (CCM)

Key Fields

Content Types

• Create (POST): application/rdf+xml
• Read (GET): application/json (Accept header)
• Update (PUT): application/json with If-Match: {ETag}

Development

uv sync --group dev
uv run pytest tests/ -v --cov=elm_alm_py
uv run ruff check src/ tests/

Known Limitations

• _find_default_category returns first category from list (may not be correct for your project). Use filed_against parameter explicitly.
• update_workitem supports title, description, owner, estimate_hours, planned_for, and custom_fields.
• OSLC CM 1.0 services.xml parsing is bypassed — creation URL is constructed directly.

License

MIT