conformidade-pbtr-mcp

基础项目与技术条款的合规性自动化分析（MCP 服务器，pt-BR）。

MCP 服务器，用于对照 SERPRO 的分析指南分析基础项目（PB）和技术条款（TR）。您发送 PDF 并说 "对 PB 进行合规性分析"；服务器返回合规性指数、优先待办事项以及 DOCX、XLSX、PDF、Markdown 和 JSON 格式的报告。

SERPRO — 联邦数据服务 的项目。

检查内容

检查清单的规则是条件性的。服务器推断签约背景 — 招标、直接签约、豁免、服务、商品、咨询、培训、呼叫、订阅、ARP、硬件/汇率、有效期超过 60 个月 — 并仅应用指南中的相关分支。其余显示为 不适用，并说明原因。如果没有这一点，硬件 PB 会因缺少咨询的强制理由而收到数十个虚假的"不符合"。

五种状态，而非两种

符合 / 不符合 是不够的：指南中的多个项目要求人工判断（"检查它们之间是否一致"）。报告使用：

Related MCP server: Tri-Tender Pricing MCP

葡萄牙语审查如何运作

审查文本的是调用 MCP 的模型 — 它已将文档置于上下文中，因此服务器打开与另一个模型的第二次对话来重新阅读同一文本没有意义。服务器负责确定性部分，并交付分段文本供智能体阅读。

因此，智能体自行串联的三步流程：

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 — 特别是关于端点暴露的部分。镜像约 250 MB，可在 512 MB 内存下运行。

公开的工具

主要流程：

辅助工具：

提示词 conducir_analisis_conformidad：智能体进行分析的引导指南，包括发现的呈现顺序，以及在没有分析将其分类为合规的情况下不得声称合规的指令。

直接使用（无需 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。

已知限制

• 项目标签页 — 系统项目标签页与 PB 数量之间的核对无法从 PDF 进行。该项目始终显示为 人工验证。

• 扫描版 PDF — 没有文本层就无法分析。extraer_estructura 会指出该情况；请先应用 OCR。

• 附件 — 检查文档是否引用附件，而不是检查文件是否存在于流程中。

• 存在 ≠ 充分 — 引擎确认事项已处理；理由的实质仍由作者负责。

文档

• docs/MANUAL.md — 微型使用手册，供分析者使用

• docs/ARQUITECTURA.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 由 ejemplos/gerar_pb_test.py 生成，包含编号、算术、按文字数值和葡萄牙语方面的故意错误 — 这保证了每个验证器都能继续捕获它应该捕获的内容。

许可证

MIT — 版权所有 (c) 2026 SERPRO。