Mestre Prático • Brazil Retail & Commodities MCP

Mestre Prático & NutriPreço — 巴西零售、燃油与医疗保健价格情报 MCP 服务

官方主权 Model Context Protocol (MCP) 服务，提供实时审计的燃油价格（ANP）、基本食品篮子指数（SEFAZ NFC-e / Decree 11.936/2024）、13 kg 家用 LPG 瓶装燃气（ANP）、受监管药品与 Farmácia Popular（CMED / ANVISA），以及覆盖全部巴西 27 个州和 417 多座城市的宏观生活成本综合分析。

由 Holding Arthur Luis Vieira dos Santos — Tecnologia e Inteligência de Varejo Inova Simples (I.S.)（CNPJ 69.423.752/0001-61 — Mestre Prático 与 NutriPreço）开发并维护。

---

重要

📊 关于历史时间序列、多实验室药品对比与完整时段数据集的架构说明

根据审慎的商业治理原则，并依据巴西版权法第 9.610/98 号（第 7 条第 XIII 款）保护知识产权，未经身份验证的社区／发现层级仅提供实时现货价格（T+0）和精选时段采样数据（每次查询最多 3 家加油站／2 家 LPG 经销商／3 种药品）。

完整历史价格时间序列（12 至 36 个月的 ANP/SEFAZ/CMED 通胀曲线）、多实验室药品治疗等效性与跨州价格对比，以及不限量的 417 多城市批量数据集均已完整索引于我们的主权数据金库中，仅向企业与商业 API 许可证持有者开放（Authorization: Bearer <ENTERPRISE_API_KEY>）。

👉 即时自助式形式发票与企业 API 密钥开通： https://mestrepratico.com.br/developers

---

🌐 在线远程 MCP 端点（无需安装的 HTTP／边缘服务）

• 端点 URL： https://mestrepratico.com.br/mcp/v1
• 传输方式： Streamable HTTP（POST /mcp/v1，JSON-RPC 2.0；以及用于发现清单的 GET /mcp/v1）+ 本地 stdio 桥接（index.js / Docker）。
• 企业 B2B 门户与形式发票： https://mestrepratico.com.br/developers

---

🤖 Agent 间（A2A）层 — 完整三支柱 MCP 合规性

我们的服务是通过认证的完整三支柱 Model Context Protocol (MCP) 实现，支持 3 种协议原语的完整认知代理能力：

1. tools（11 个主权工具）： 围绕燃油、食品杂货、药品、工时、电价、运费和税费，即时调用耗时不足 100 ms 的 RPC 函数。
2. prompts（5 个认知 A2A 工作流）： 结构化多步骤推理模板（analisar_orcamento_familiar、auditar_viabilidade_logistica_antt、raio_x_tributario_reforma、auditar_preco_farmacia、analise_combustivel_frota），引导自主 Agent 执行审计、计算并综合生成执行摘要。
3. resources（8 个规范 URI）： 直接为 AI Agent 注入实时数据，无提示词注入风险（mcp://brazil/macro/bcb-series、mcp://brazil/energy/aneel-tariffs、mcp://brazil/logistics/antt-freight-table、mcp://brazil/tax/confaz-icms-monofasico 等）。

---

🛠️ 11 个主权 brazil_* 工具（Glama A 级 — TDQS 4.4/5.0）

全部 11 个工具均严格遵循 brazil_* 命名规范、JSON Schema 输入约束和官方 MCP annotations（readOnlyHint: true、destructiveHint: false、idempotentHint: true、openWorldHint: true）：

工具名称	主要主管机构	公开抽样数据（免费层级）	企业版解锁内容（Bearer <API_KEY>）
brazil_fuel_prices	ANP / SEFAZ NFC-e	审核通过的前 3 家加油站 + 州平均价格（汽油、乙醇、Diesel S10、CNG）	覆盖 417+ 个城市的全部 4,750+ 家加油站 + 每周历史时间序列
brazil_grocery_basket	SEFAZ NFC-e / 超市	区域购物篮即时总价和主要超市连锁（13 种必需品）	按门店划分的 SKU 明细 + 每日历史通胀时间序列
brazil_cost_of_living	宏观经济 / Dieese	单州月度食品 + 燃油 + 交通综合指数（BRL/USD）	多城市纵向购买力平价（PPP）及历史趋势
brazil_lpg_gas_prices	ANP 开放数据	前 2 家获授权的 13kg LPG 炊事燃气转售商 + 州平均/最低/最高价格	全部 13,145+ 家转售商的社区配送价差 + 历史序列
brazil_pharma_medicines	CMED / ANVISA / SUS	最多 3 个匹配规格，包含出厂价（PF）、PMC 和 Farmácia Popular 信息	完整的 26,635+ 项 ANVISA 目录 + 多实验室仿制药与原研药对比及历史记录
brazil_list_states	发现元数据	全部 27 个巴西 UF 代码、加油站覆盖数量、ICMS 税率和时间戳	完整的市镇 slug 目录及实时 webhook 同步元数据
brazil_purchasing_power_oracle	DIEESE / BACEN / IBGE / ANEEL	购买每月 13 种商品购物篮、13kg LPG、燃油和 150 kWh 电力所需的最低工资工时	按州划分的实际购买力平价（PPP）及历史工时趋势
brazil_energy_tariffs	ANEEL / ANP	覆盖全部 27 个 UF 的核定居民 B1 电价 + 炊事热能平价（GLP 与电磁炉）	配电网络成本明细及季节性电价标记（Bandeiras Tarifárias）
brazil_freight_logistics	ANTT / ANP	按距离/车轴计算的公路货运成本底价 + Diesel S10 消耗量及每公斤食品的运输成本	车队调度优化及大宗谷物公路走廊货运曲线
brazil_tax_anatomy	CONFAZ / EC 132	覆盖全部 27 个 UF 的宪法税收构成分析（ICMS 单相税与产品净价）	按州划分的财政构成及税制改革 IBS/CBS 双税率过渡分析
brazil_compare_regions	跨州综合分析	燃油与食品杂货差价并列对比 + 70% 乙醇/汽油平价比率	跨州多行业对比（包括 Pharma ICMS 18% 与 20% 的对比及 LPG）

---

💼 商业授权与定价层级

层级	吞吐量与覆盖范围	历史时间序列与批量数据	月度费用
1. 社区版 / 评估版	精选样本（每次调用最多 3 项，每个窗口 10 次调用），必须注明来源	仅限即时数据（T+0）	免费（US$ 0）
2. 商业 AI Agent / 初创企业	可无限查询全部 417+ 个城市 + Edge ASN 白名单（Authorization: Bearer）	12 个月历史时间序列 + Pharma 对比工具	US$ 490 / 月（或 R$ 2.450/月）
3. 企业版 / 全球平台	专属高频 SLA、自定义 webhooks、原始批量数据源及法律赔偿保障	完整 36 个月历史时间序列 + 全部 7 个垂直领域	US$ 1,950 / 月（或 R$ 9.800/月）

• 10 秒内生成形式发票：https://mestrepratico.com.br/developers
• 企业授权联系处：[email protected] | [email protected]

---

⚡ 通过 Smithery 一键安装（Claude Desktop、Cursor、Cline）

使用一条终端命令自动安装：

npx -y @smithery/cli install @mestrepratico/brazil-prices-mcp

或通过远程 HTTP 直接连接：

⚡ 快速连接（Claude Desktop、Cursor、Windsurf、Glama）

{
  "mcpServers": {
    "mestrepratico-brazil": {
      "type": "http",
      "url": "https://mestrepratico.com.br/mcp/v1",
      "headers": {
        "Authorization": "Bearer YOUR_ENTERPRISE_API_KEY_OPTIONAL"
      }
    }
  }
}

---

🛡️ 安全与知识产权治理

受取证用 Canary Tokens（NC-CANARY-BRL-*）保护，依据 《巴西版权法》第 9.610/98 号（第 7 条第 XIII 款）、**《伯尔尼公约》**和 17 U.S.C. § 1202。未经授权轮换代理、系统性抓取或移除来源署名（"Fonte: Mestre Prático — mestrepratico.com.br"）将触发自动边缘 ASN 封锁（HTTP 402/403），并按每次侵权承担 **US$ 100,000.00（R$ 500.000,00）**的法定约定赔偿金。