conformidade-pbtr-mcp

Automatisierte Konformitätsanalyse von Basisprojekten und Leistungsbeschreibungen (MCP-Server, pt-BR).

MCP-Server, der Basisprojekte (PB) und Leistungsbeschreibungen (TR) gegen den Analyseleitfaden des SERPRO prüft. Sie senden das PDF und sagen "Konformitätsanalyse des PB durchführen"; der Server liefert den Konformitätsindex, die priorisierten offenen Punkte und die Berichte als DOCX, XLSX, PDF, Markdown und JSON.

Projekt der SERPRO — Serviço Federal de Processamento de Dados.

Was geprüft wird

Die Regeln der Checkliste sind bedingt. Der Server leitet den Kontext der Beschaffung ab — Ausschreibung, Direktvergabe, Unzumutbarkeit, Dienstleistung, Ware, Beratung, Schulung, Tickets, Abonnement, ARP, Hardware/Wechselkurs, Laufzeit über 60 Monate — und wendet nur die relevanten Zweige des Leitfadens an. Die übrigen erscheinen als Nicht zutreffend, mit Angabe des Grunds. Ohne dieses Vorgehen würde ein Hardware-PB dutzende falsche "nicht konform" erhalten, weil die Pflichtbegründungen für Beratung fehlen.

Fünf Status, nicht zwei

konform / nicht konform wäre unzureichend: Mehrere Punkte des Leitfadens erfordern menschliches Urteilsvermögen ("prüfen, ob Kohärenz zwischen ihnen besteht"). Der Bericht verwendet:

Related MCP server: Tri-Tender Pricing MCP

Wie die Portugiesisch-Revision funktioniert

Den Text überprüft das Modell, das den MCP aufgerufen hat — es hat das Dokument bereits im Kontext, daher ergibt es keinen Sinn, dass der Server eine zweite Konversation mit einem anderen Modell eröffnet, um denselben Text erneut zu lesen. Der Server kümmert sich um das Deterministische und liefert den Text segmentiert für den Agenten zum Lesen.

Daraus ergibt sich der dreistufige Ablauf, den der Agent selbstständig verkettet:

1. analisar_conformidade      → checklist, numeração, tabelas, valores
                                 (+ regras determinísticas de revisão)
2. obter_texto_para_revisao   → o agente lê e revisa o português
3. registrar_revisao_textual  → apontamentos entram e os relatórios saem

Jeder Hinweis des Agenten gelangt nur dann in den Bericht, wenn die zitierte Textstelle tatsächlich im Dokument vorhanden ist. Die Überprüfung erfolgt gegen den extrahierten Text, wobei Unterschiede bei Leerzeichen und Anführungszeichen toleriert werden. Wenn das Modell nicht angeben kann, wo der Fehler liegt, wird der Hinweis verworfen und in recusados mit Begründung zurückgegeben — das unterscheidet eine nützliche Revision von einer Halluzination in einem Bericht, der ein Verwaltungsverfahren anleitet.

Jeder Befund zitiert den PB/TR-Punkt ("Punkt 6.3.1"), nicht nur die Seite — in einem dichten Dokument lokalisiert die Seite den Textabschnitt für den, der korrigieren soll, nicht. Der Punkt wird aus dem Zitat aufgelöst, nicht aus dem, was das Modell angibt: Wenn es die Nummerierung falsch angibt, gilt das, was das Dokument sagt.

Im Bericht erscheinen diese Vorschläge in einem eigenen Abschnitt, als nicht reproduzierbar markiert, und bleiben außerhalb des Konformitätsindex. Exakte Prüfung und Lesevorschlag haben unterschiedliche Gewichte für den, der das Gutachten unterzeichnet.

Installation

Einzige Voraussetzung: Python 3.11+. Es gibt keine Java-Abhängigkeit und keinen externen Dienst.

git clone https://github.com/charlesmmorais/conformidade-pbtr-mcp.git
cd conformidade-pbtr-mcp
python -m venv .venv && source .venv/bin/activate   # Windows: .venv\Scripts\activate
pip install -e .

Registrierung in Claude Desktop / Claude Code (claude_desktop_config.json):

{
  "mcpServers": {
    "conformidade-pbtr": {
      "command": "/caminho/para/conformidade-pbtr-mcp/.venv/bin/conformidade-pbtr",
      "env": {
        "CONFORMIDADE_PBTR_SAIDA": "/caminho/onde/gravar/os/relatorios"
      }
    }
  }
}

Gehostetes Deployment (Fly.io)

Der Server spricht stdio lokal und HTTP, wenn gehostet. Das Repository enthält fertige Dockerfile und fly.toml:

fly launch --no-deploy --copy-config
fly deploy
curl https://<sua-app>.fly.dev/health

Im gehosteten Modus teilt der Client keinen Datenträger mit dem Server: Das PDF wird in conteudo_base64 hochgeladen und die Berichte kommen eingebettet in der Antwort zurück. Lesen Sie docs/DEPLOY.md vor dem ersten Deployment — insbesondere den Abschnitt zur Offenlegung des Endpunkts. Das Image hat ~250 MB und läuft mit 512 MB.

Exponierte Tools

Hauptablauf:

Hilfstools:

Prompt conduzir_analise_conformidade: Leitfaden für die Durchführung der Analyse durch den Agenten, einschließlich der Reihenfolge der Darstellung der Befunde und der Anweisung, keine Konformität zu behaupten, ohne dass die Analyse sie als solche eingestuft hat.

Direkte Nutzung (ohne MCP)

from conformidade_pbtr import analisar
from conformidade_pbtr.relatorios import gerar_docx

rel = analisar("PB_123_2026.pdf", tipo="PB")
print(rel.resumo.indice_conformidade)
gerar_docx(rel, "Relatorio_Conformidade.docx")

Konformitätsindex

Gewichteter Durchschnitt nach Schweregrad (kritisch 4, hoch 3, mittel 2) über die automatisch bewertbaren Punkte. Punkte mit Nicht zutreffend, Manuell prüfen, die Hinweise zur Textrevision und die Vorschläge des Agenten bleiben außerhalb der Berechnung, um die Note nicht zu verzerren.

Steckbare Checkliste

Das gesamte normative Wissen liegt in recursos/checklist_roteiro_ti.yaml — der Motor kennt keine Norm. Um eine Leitfadenrevision zu begleiten, bearbeiten Sie das YAML und erhöhen Sie die versao in metadata; Name und Version der verwendeten Checkliste werden in jedem Bericht gespeichert, was die Analyse über die Zeit hinweg auditierbar macht.

Das Projekt bedient derzeit das SERPRO. Die Unterstützung einer anderen Behörde bedeutet, ein YAML in recursos/ hinzuzufügen und CONFORMIDADE_PBTR_CHECKLIST darauf zu verweisen — keine Codeänderung. Das Format ist in docs/CHECKLIST.md beschrieben.

Bekannte Grenzen

• Registerkarte Itens — der Abgleich zwischen der Registerkarte Itens des Systems und den Mengen des PB ist anhand des PDFs nicht möglich. Der Punkt wird immer als Manuell prüfen ausgegeben.

• Gescanntes PDF — ohne Textebene gibt es keine Analyse. extrair_estrutura weist darauf hin; wenden Sie vorher OCR an.

• Anhänge — es wird geprüft, ob das Dokument die Anhänge zitiert, nicht ob die Dateien im Verfahren existieren.

• Vorhandensein ≠ Angemessenheit — der Motor bestätigt, dass das Thema behandelt wurde; die inhaltliche Bewertung der Begründung bleibt dem Gutachter überlassen.

Dokumentation

• docs/MANUAL.md — Mikro-Benutzerhandbuch für die Analyse

• docs/ARQUITETURA.md — Projektentscheidungen, Datenmodell und Roadmap

• docs/CHECKLIST.md — YAML-Format und wie man gute Auslöser schreibt

• docs/DEPLOY.md — Deployment auf Fly.io, Remote-Modus und Umgebungsvariablen

• CONTRIBUTING.md — wie man beiträgt

Entwicklung

pip install -e ".[dev]"
pytest -q          # testes sobre um PB sintético com erros plantados
ruff check .

Das Test-PB wird von exemplos/gerar_pb_teste.py erzeugt, mit absichtlichen Fehlern bei Nummerierung, Arithmetik, Betrag in Worten und Portugiesisch — das stellt sicher, dass jeder Validator weiterhin das findet, was er finden soll.

Lizenz

MIT — Copyright (c) 2026 SERPRO.