MCP Fiorilli Transparencia

Servidor MCP para portais de transparencia com Fiorilli SCPI.

O que mudou (v3)

• Resposta padrao em JSON estruturado (structuredContent) em todas as tools.

• Paginacao/chunking para evitar truncamento e travamento de contexto.

• Indexacao local do Diario Oficial com SQLite FTS5.

• Busca do Diario baseada em indice persistente, com indexacao incremental por lotes.

• Arquitetura MCP em tools-only (sem prompts/* e resources/*).

• analise_* removidas da superficie MCP; analises devem ser compostas no cliente consumidor.

• Filtros locais em todas as tools de dados:

  • _pagina, _por_pagina, _cursor

  • _busca, _campos, _ordenar_por, _ordem

• Suporte a transporte MCP por HTTP (Streamable HTTP) para deploy publico no Render.

• Portal fixo em Paraguaçu Paulista por padrão.

• configurar_portal endurecido para publico:

  • so altera configuracao se MCP_ALLOW_CONFIG_UPDATE=true.

Related MCP server: cnpjaberto

Ferramentas

Conjunto atual: tools de despesas, receitas, licitacoes/contratos, transferencias, pessoal e diario oficial.

Instalacao

npm install
npm run build

Variaveis de ambiente

# Transporte MCP: stdio (default) ou http
MCP_TRANSPORT=stdio

# Porta/host para modo HTTP
PORT=3000
HOST=0.0.0.0

# Seguranca para servidor publico
MCP_ALLOW_CONFIG_UPDATE=false
MCP_ALLOWED_HOSTS=paraguacu-transparente-mcp.onrender.com,localhost,127.0.0.1

# Tuning de payload
MCP_DEFAULT_PAGE_SIZE=100
MCP_MAX_PAGE_SIZE=500
MCP_TEXT_BLOCK_CHARS=12000
MCP_TOOLS_LIST_PAGE_SIZE=200

# Tuning do Diario Oficial
MCP_DATA_DIR=/var/data/paraguacu-mcp
MCP_DIARIO_SCAN_BATCH_SIZE=8
MCP_DIARIO_SCAN_MAX_BATCHES=4
MCP_DIARIO_SCAN_TIME_BUDGET_MS=70000

Execucao local

# stdio (desktop clients)
npm start

# HTTP (Render / publico)
MCP_TRANSPORT=http npm start

Endpoints no modo HTTP:

• POST /mcp

• GET /mcp

• DELETE /mcp

• GET /health

Deploy no Render

• Build command: npm install && npm run build

• Start command: node dist/index.js

• Env obrigatorias:

  • MCP_TRANSPORT=http

  • PORT (Render injeta automaticamente)

• MCP_ALLOW_CONFIG_UPDATE=false (recomendado)

  • MCP_ALLOWED_HOSTS com o dominio publico do Render

• Para manter o indice do Diario entre deploys/restarts, monte um disco persistente no path usado por MCP_DATA_DIR.

Notas de output

• O campo content traz preview textual curto.

• O payload completo da resposta fica em structuredContent.

• Para resultados grandes, use next_cursor (ou _pagina) para navegar sem perder dados.

Licenca

MIT