conformidade-pbtr-mcp

Projetos Básicos 및 Termos de Referência의 규정 준수 자동 분석 (MCP 서버, pt-BR).

SERPRO의 분석 로드맵에 따라 Projetos Básicos(PB) 및 Termos de Referência(TR)를 분석하는 MCP 서버입니다. PDF를 보내고 *"PB 규정 준수 분석 수행"*이라고 말하면, 서버가 규정 준수 지수, 우선순위가 매겨진 미비 사항, DOCX, XLSX, PDF, Markdown 및 JSON 형식의 보고서를 반환합니다.

SERPRO — Serviço Federal de Processamento de Dados 프로젝트입니다.

검사 항목

체크리스트 규칙은 조건부입니다. 서버는 계약 맥락(입찰, 직접 계약, 면제, 서비스, 재화, 컨설팅, 교육, 티켓, 구독, ARP, 하드웨어/환율, 60개월 초과 계약 기간)을 추론하고 로드맵의 관련 분기만 적용합니다. 나머지는 해당 없음으로 표시되며 그 이유가 명시됩니다. 그렇지 않으면 하드웨어 PB는 필수 컨설팅 근거를 포함하지 않았다는 이유로 수십 개의 잘못된 "부적합" 판정을 받게 됩니다.

두 가지가 아닌 다섯 가지 상태

conforme / não conforme만으로는 부족합니다. 로드맵의 여러 항목은 인간의 판단을 요구하기 때문입니다("항목 간 일관성 확인"). 보고서는 다음을 사용합니다:

Related MCP server: Tri-Tender Pricing MCP

포르투갈어 검토 작동 방식

텍스트를 검토하는 주체는 MCP를 호출한 모델입니다. 이미 문서가 컨텍스트에 있으므로, 서버가 다른 모델과 두 번째 대화를 열어 같은 텍스트를 다시 읽게 할 이유가 없습니다. 서버는 결정적인 부분을 처리하고, 에이전트가 읽을 수 있도록 분할된 텍스트를 전달합니다.

따라서 에이전트가 스스로 연결하는 3단계 흐름이 있습니다:

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

에이전트의 각 지적은 인용된 구절이 문서에 문자 그대로 존재할 때만 보고서에 포함됩니다. 확인은 추출된 텍스트를 기준으로 수행되며, 공백 및 따옴표 차이는 허용됩니다. 모델이 오류 위치를 지적할 수 없으면 해당 지적은 폐기되고 recusados에 사유와 함께 반환됩니다. 이것이 행정 절차를 안내하는 보고서에서 유용한 검토와 환각을 구분하는 기준입니다.

모든 발견 사항은 페이지뿐만 아니라 PB/TR 항목("항목 6.3.1")을 인용합니다. 문서가 조밀할 때 페이지는 수정할 사람이 해당 구절을 찾는 데 도움이 되지 않습니다. 항목은 모델이 선언한 내용이 아닌 인용문에서 확인됩니다. 모델이 번호를 잘못 입력해도 문서에 표시된 내용이 우선합니다.

보고서에서 이러한 제안은 별도 섹션에 표시되며 재현 불가로 표시되고 규정 준수 지수에서 제외됩니다. 정확한 검증과 읽기 제안은 소견서에 서명하는 사람에게 서로 다른 가중치를 갖습니다.

설치

유일한 요구 사항: Python 3.11+. Java 종속성이나 외부 서비스가 없습니다.

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 .

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"
      }
    }
  }
}

호스팅 배포 (Fly.io)

서버는 로컬에서 stdio를, 호스팅 시 HTTP를 사용합니다. 저장소에는 Dockerfile과 fly.toml이 준비되어 있습니다:

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

호스팅 모드에서는 클라이언트가 서버와 디스크를 공유하지 않습니다. PDF는 conteudo_base64로 업로드되고 보고서는 응답에 포함되어 반환됩니다. 첫 배포 전에 docs/DEPLOY.md를 읽으십시오 — 특히 엔드포인트 노출에 관한 섹션을 확인하세요. 이미지 크기는 약 250MB이며 512MB에서 실행됩니다.

노출된 도구

기본 흐름:

보조 도구:

conduzir_analise_conformidade 프롬프트: 에이전트의 분석 수행 로드맵 — 발견 사항 표시 순서와 분석이 적합으로 분류하지 않은 경우 적합을 주장하지 말라는 지시 포함.

직접 사용 (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")

규정 준수 지수

자동 평가 가능한 항목에 대한 심각도 가중 평균(치명적 4, 높음 3, 중간 2)입니다. 해당 없음, 수동 확인 필요, 텍스트 검토 지적 및 에이전트 제안은 점수를 왜곡하지 않도록 계산에서 제외됩니다.

플러그형 체크리스트

모든 규범 지식은 recursos/checklist_roteiro_ti.yaml에 있습니다. 엔진은 어떤 규범도 알지 못합니다. 로드맵 개정을 따라가려면 YAML을 편집하고 metadata의 versao를 올리십시오. 사용된 체크리스트의 이름과 버전은 각 보고서에 기록되어 시간에 따른 분석의 추적 가능성을 보장합니다.

현재 프로젝트는 SERPRO를 지원합니다. 다른 기관을 지원하려면 recursos/에 YAML을 추가하고 CONFORMIDADE_PBTR_CHECKLIST를 해당 파일로 지정하면 됩니다. 코드 변경은 필요 없습니다. 형식은 docs/CHECKLIST.md에 있습니다.

알려진 한계

• Aba Itens — 시스템의 Aba Itens과 PB 수량 간의 대조는 PDF만으로는 불가능합니다. 항목은 항상 수동 확인 필요로 표시됩니다.

• 스캔된 PDF — 텍스트 레이어가 없으면 분석이 불가능합니다. extrair_estrutura가 이 경우를 알리며, 먼저 OCR을 적용하십시오.

• 부록 — 문서가 부록을 인용하는지 확인할 뿐, 파일이 절차에 존재하는지는 확인하지 않습니다.

• 존재 ≠ 적절성 — 엔진은 주제가 다루어졌는지 확인합니다. 근거의 실질적 타당성은 여전히 소견서 작성자의 몫입니다.

문서

• docs/MANUAL.md — 분석을 수행할 사람을 위한 간단 사용 매뉴얼

• docs/ARQUITETURA.md — 프로젝트 설계 결정, 데이터 모델 및 로드맵

• docs/CHECKLIST.md — YAML 형식 및 좋은 트리거 작성 방법

• docs/DEPLOY.md — Fly.io 배포, 원격 모드 및 환경 변수

• CONTRIBUTING.md — 기여 방법

개발

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

테스트 PB는 exemplos/gerar_pb_teste.py로 생성되며, 번호 매기기, 산술, 숫자/한글 금액 표기 및 포르투갈어에 의도적 오류가 포함되어 있습니다. 이를 통해 각 검증기가 계속해서 잡아야 할 오류를 잡는지 확인할 수 있습니다.

라이선스

MIT — Copyright (c) 2026 SERPRO.