mcp-elm

Servidor MCP do IBM ELM — EWM (work items), DOORS Next (requisitos) e ETM (casos de teste) — para o power sdd. Expõe operações: o servidor lê a configuração da project area no projeto (pa_<nome>.json) e a LLM passa só ids e conteúdo. Manual: docs/manual-mcp-elm.md.

Instalação

Publicado no PyPI e já incluído no mcp.json do power sdd; requer o uv. Em outro cliente MCP:

{
  "mcpServers": {
    "elm": {
      "type": "stdio",
      "command": "uvx",
      "args": ["mcp-elm@latest"],
      "env": { "UV_SYSTEM_CERTS": "true" }
    }
  }
}

Desenvolvimento:

uv sync
uv run mcp dev mcp_elm/server.py   # depuração com o MCP Inspector

Credenciais

~/.config/mcp-elm/elm.properties (Windows: %APPDATA%\mcp-elm\elm.properties; outro caminho: MCP_ELM_CONFIG). CA próprio: export REQUESTS_CA_BUNDLE=/caminho/ca.pem. Login pelo form Jazz, com Basic se o servidor pedir.

[DEFAULT]
server = https://elm.SEU-SERVIDOR
user = SEU_USUARIO
password = SUA_SENHA

Configuração do projeto

<projeto>/.kiro/config/sdd/pa_<nome>.json, um por project area, gravado pela skill sdd-setup. O schema é o do power sdd (pa.schema.json); o pacote leva uma cópia (mcp_elm/pa.schema.json) — mantenha as duas iguais.

Toda tool (menos elm_setup_descobrir) recebe projeto (caminho absoluto do workspace: o Kiro não inicia o MCP de um power no workspace) e pa (o <nome>; omitido só quando há um arquivo).

Resposta

Um único TextContent, sem structuredContent:

{"ok":true,"dados":{...}}
{"ok":false,"erro":{"codigo":"precondicao","detalhe":"...","campo":"Estimativa"}}

elm_ler_wi e elm_ler_req devolvem Markdown (YAML + corpo); erro nelas sai no envelope. Códigos: config, credencial, indisponivel (rede ou timeout: tente de novo), nao_encontrado, permissao, precondicao, conflito, entrada.

Tools

As _local leem o bundle em <projeto>/<rm.download> (índice em <bundle>/sqlite3/okf.db); depois do elm_sync baixar, indexe com elm_indexar_local. Sem nada baixado devolvem nao_encontrado com campo: "bundle": baixe com elm_sync ou pesquise no ELM remoto (elm_buscar_req/elm_ler_req). Detalhes no manual.

Testes e paridade

uv run --with pytest python -m pytest -q
uv run python paridade/paridade.py <projeto> --pa <nome> --wi <id> --req <id> [--iteracao <nome>]

A paridade compara as leituras com o 1.0.43 (commit a73e925) contra o ELM real; veja o manual.