SIA API

API FastAPI inicial para integração somente leitura com o SIA.

O que já existe

• GET /health

• GET /db/ping

• GET /db/relations

• GET /db/relations/{relation_name}/columns

• GET /presos

• GET /presos/{matricula}

• GET /presos/{matricula}/visitas

• GET /presos/{matricula}/visitas/timeline

• GET /presos/{matricula}/atendimentos

• GET /presos/{matricula}/atendimentos/historico

• GET /atendimentos/locais

• GET /atendimentos/advogados

• GET /atendimentos/do-dia?data_ref=YYYY-MM-DD

• GET /atendimentos/soltos/agora

• GET /sentenciados/sem-execucao

Related MCP server: KVMFleet MCP Server

MCP para o Hermes

A API também expõe uma camada FastMCP em /mcp.

Ferramentas disponíveis:

• sia_db_ping

• sia_list_presos

• sia_get_preso

• sia_list_visitas

• sia_list_visitas_timeline

• sia_list_atendimentos

• sia_list_atendimentos_historico

• sia_list_atendimento_locais

• sia_list_atendimento_advogados

• sia_list_atendimentos_do_dia

• sia_soltos_agora

• sia_list_sentenciados_sem_execucao

Exemplo de uso local no Hermes:

uvicorn app.main:app --reload

Depois, o cliente MCP deve apontar para o endpoint HTTP da aplicação com o caminho /mcp.

Conexão Firebird

A conexão é montada a partir destas variáveis de ambiente:

SIA_FIREBIRD_HOST=10.14.161.210
SIA_FIREBIRD_PORT=3050
SIA_FIREBIRD_DATABASE=/home/sia/banco/dbsia.fdb
SIA_FIREBIRD_USER=SYSDBA
SIA_FIREBIRD_PASSWORD=***
SIA_FIREBIRD_CHARSET=WIN1252

Opcional:

SIA_FIREBIRD_CLIENT_LIBRARY=/caminho/para/libfbclient.so

Rodar localmente

python3 -m venv .venv
. .venv/bin/activate
pip install -U pip
pip install -e .[dev]
pytest
uvicorn app.main:app --reload

Observações importantes

• Este ambiente foi tratado como produção.

• A API foi travada para consultas בלבד.

• Não há endpoint de inserção ou exclusão.

• Os testes atuais validam que SQL não-SELECT é bloqueado pela camada de acesso.

Próximo passo

Mapear as tabelas/vistas reais do SIA para criar endpoints de domínio (presos, visitas, etc.) sem tocar em escrita.