Mcp Fiscal Brasil

本地服务

dehor-labs.github.io金融数据3974 天前更新

代码仓库访问官网

关于 Mcp Fiscal Brasil

Mcp Fiscal Brasil 是面向 AI 助手、ERP、CRM 和内部自动化的巴西税务及企业数据 Python MCP 服务。它结合在线查询、离线文档解析与验证、内置参考表和高阶合规工作流，默认无需账户或 API 密钥。

主要功能

01查询 CNPJ、CPF 和 Simples Nacional
02解析、验证 NF-e XML 并生成 DANFE
03离线分析 SPED 与 eSocial
04内置 NCM、CFOP 和 CNAE 参考表
05供应商风险评估与企业批量处理
06通过可选 A1 证书执行 SEFAZ 操作

适用场景

01审查供应商的税务合规与风险
02验证 NF-e 数据或生成 DANFE PDF
03汇总 SPED 文件并发现不一致
04比较企业场景下的税务制度

MCP 相关

该 MCP 服务向 MCP 客户端开放巴西税务查询、文档解析与验证、合规、供应商风险和税制比较工具。许多功能无需 API 密钥；部分 SEFAZ 操作需要 A1 证书。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "fiscal-brasil": {
      "command": "uvx",
      "args": [
        "mcp-fiscal-brasil"
      ]
    }
  }
}

启动命令uvx mcp-fiscal-brasil

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

pypimcp-fiscal-brasil0.2.1stdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

唯一原生支持 NF-e、NFS-e、SPED、eSocial、Simples Nacional 和 2026 年税制改革（IBS/CBS）的 MCP 服务——无需账户、密钥或配置。

🌐 网站 · 📚 文档 · 安装 · 工具 · 工作流 · 路线图 · 参与贡献

快速开始

uvx mcp-fiscal-brasil

始终保持最新： uvx 会缓存已安装的版本。使用 uvx mcp-fiscal-brasil@latest 或 uvx --refresh mcp-fiscal-brasil，即可强制获取 PyPI 上的最新版本。

Claude Desktop

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %APPDATA%\Claude\claude_desktop_config.json（Windows）：

{
  "mcpServers": {
    "fiscal-brasil": {
      "command": "uvx",
      "args": ["mcp-fiscal-brasil"]
    }
  }
}

重启 Claude Desktop。税务工具将自动显示，无需任何 API 密钥。

为什么选择 mcp-fiscal-brasil，而不是其他巴西 MCP 服务？

功能	mcp-fiscal-brasil	mcp-brasil	brasil-data-mcp
侧重点	深度垂直税务领域	通用公共数据	通用公共数据
NF-e：解析、验证、DANFE、签名	是	否	否
SPED/eSocial：离线分析	是	否	否
离线表格（NCM、CFOP、CNAE）	是	否	否
2026 年税制改革（IBS/CBS）	是	否	否
Simples Nacional/MEI	是	否	否
联邦税务证明/FGTS	是（指导）	否	否
A1 证书（mTLS SEFAZ）	是（可选启用）	否	否
零注册、无需必备密钥	是	部分（3 个 API 要求密钥）	是
高阶 Agent 工具	是（6 个工具）	部分	否
实现语言	Python	Python	Node.js

mcp-brasil（1.6k 个星标）和 brasil-data-mcp 涵盖 CEP、银行、节假日、经济等通用公共数据。本项目则专注于不同领域：税务垂直领域，提供离线 XML 解析、XSD 验证、内置参考表以及对 2026 年税制改革的支持。侧重点不同，面向的用户群体也不同。

是什么

mcp-fiscal-brasil 将 AI 助手、ERP、CRM 和内部自动化连接到巴西税务领域：CNPJ、CPF、Simples Nacional、NFe、NFSe、SPED、eSocial、税务证明和供应商尽职调查。

它并不想成为通用的公共数据目录，而是致力于打造一个垂直产品：将零散的税务查询转化为安全、可组合且可供 Agent 使用的工具。

能自动成交的工作流

工作流	主要工具	结果
供应商尽职调查	`risk_score_supplier`	0-100 分的评分、风险、影响因素和合作建议
批量筛查	`consultar_empresas_lote`	一次调用查询多个 CNPJ，并为每家企业提供合规信息和评分
CNPJ 合规检查	`analyze_cnpj_compliance`	将 CNPJ、Simples/MEI 和 CNAE 整合为可执行的报告
NFe 验证	`validate_nfe_full`	检查 XML、密钥和开票方，并提供结构化问题列表
SPED 摘要	`summarize_sped`	提供执行摘要、期间、企业、区块和不一致项
税务规划	`compare_tax_regimes`	对比 MEI、Simples、Lucro Presumido 和 Lucro Real

🌎 在线演示

托管的 Web UI 演示（Render 免费套餐，首次访问可能需要 30 秒唤醒）：

点击上方按钮，即可通过 3 次点击在 Render.com 上托管自己的实例。

其他选项（Fly.io、通过 Docker 自托管）请参阅 docs/getting-started/deploy.md。

✨ v0.2.x 新增内容

这一版本围绕 4 个方向进行升级：

新增 8 个数据源：CNAE、CPF、Simples Nacional、MEI、IBGE、CEP、企业综合信息、税务证明
Agent 工具（高层级）：analyze_cnpj_compliance、risk_score_supplier、consultar_empresas_lote、compare_tax_regimes、validate_nfe_full、summarize_sped
多种接口：除了 MCP 服务，现在还提供 CLI（mcp-fiscal）、REST API（mcp-fiscal-api）和 Web UI 演示，以及预览版 Node.js 封装（npm-wrapper/）
生产级特性：支持指数退避重试的 HTTP 客户端、可插拔缓存、按主机限流、结构化 JSON 日志

# CLI standalone
mcp-fiscal cnpj 12345678000190
mcp-fiscal compliance 12345678000190
mcp-fiscal regimes --faturamento 500000 --setor serviços --folha 180000

# REST API + Web UI demo
mcp-fiscal-api  # http://localhost:8000

# Node.js
import { analyzeCompliance } from "mcp-fiscal-brasil";

详情请参阅 CHANGELOG.md。

为什么要创建这个项目？

巴西拥有全球最复杂的税务基础设施之一，包括 27 个州级 SEFAZ、NFe + NFSe + SPED + eSocial、数千个拥有独立门户的网站的市，以及每天努力维持税务合规的数百万家企业。

在这个项目出现之前，将 AI 接入任何巴西税务数据都需要定制开发、在多个门户进行身份验证，并深入了解每个政府 API。每项查询都相当于一个项目。

MCP Fiscal Brasil 用一行命令解决这个问题：安装服务，将其连接到你的 AI 助手，然后开始用自然语言提问。服务会处理一切，直接查询联邦税务局、BrasilAPI 和各州 SEFAZ。

🎬 演示

Você:  "Consulte o CNPJ 00.000.000/0001-91 e liste os sócios"

IA:    Empresa: Banco do Brasil S.A.
       Fundada em: 12/10/1808
       Situação: ATIVA
       CNAE principal: 6422100 - Bancos múltiplos com carteira comercial

       Sócios (QSA):
       - União Federal - Sócio-Administrador (60,82%)
       - BNDESPar - Sócio (10,32%)

Você:  "A chave NFe 35240300623904000197550010000012341234567890 é válida?"

IA:    Chave válida!
       Estado de origem: SP (São Paulo)
       Data de emissão: março/2024
       CNPJ emitente: 00.623.904/0001-97
       Número da nota: 000001234
       Dígito verificador: correto (módulo 11)

Você:  "A empresa 12.345.678/0001-90 é do Simples Nacional?"

IA:    Sim! Empresa optante do Simples Nacional.
       Data de opção: 01/01/2020
       Modalidade: MEI - Microempreendedor Individual

Você:  "O SEFAZ de São Paulo está online agora?"

IA:    Status SEFAZ SP: OPERACIONAL
       Serviço de autorização de NFe funcionando normalmente.
       Última verificação: agora.

🛠 可用工具

用于税务数据的底层工具，以及用于运营决策的高层级 Agent 工具。

Agent 工具

工具	使用场景
`analyze_cnpj_compliance`	获取 CNPJ 的综合税务合规报告
`risk_score_supplier`	批准、调查或拒绝供应商
`consultar_empresas_lote`	根据评分和每个 CNPJ 的错误信息筛查供应商组合
`compare_tax_regimes`	按不同场景对比税制
`validate_nfe_full`	根据 XML 验证完整的 NFe
`summarize_sped`	将 SPED 转换为执行摘要

✅ 可用工具（现可使用）

无需 API 密钥即可 100% 正常运行。安装后即可立即使用。

模块	工具	描述	API
CNPJ	`consultar_cnpj`	完整数据：公司名称、合伙人、CNAE、地址	BrasilAPI（免费）+ cpfcnpj.com.br（高级，选择启用）
CNPJ	`consultar_simples_nacional`	Simples/MEI 纳税人资格及加入和退出日期	BrasilAPI（免费）
NFe	`validar_chave_nfe`	验证校验位 + 提取 UF、CNPJ、日期、编号	离线
NFe	`consultar_nfe`	通过 44 位密钥查询完整 NFe	BrasilAPI（免费）+ cpfcnpj.com.br（高级，选择启用）
NFe	`consultar_nfce`	通过 44 位密钥查询 NFC-e（型号 65）；完整查询需要令牌（套餐 102），否则会尝试从公共来源获取部分数据	cpfcnpj.com.br（套餐 102）+ 公共来源（部分数据）
NFe	`parse_nfe_xml`	解析 NF-e/NFC-e 原始 XML，并返回结构化数据	离线
NFe	`gerar_danfe`	根据 NF-e（型号 55）XML 生成 DANFE PDF（A4）	离线
NFe	`validar_assinatura_nfe`	验证 XMLDSig 签名并提取证书数据	离线
NFe	`consultar_status_sefaz`	通过 NfeStatusServico4 查询各州 SEFAZ Web 服务的实际状态（需要 A1 证书）	SEFAZ（mTLS）
NFe	`baixar_nfe_distribuicao`	通过 NFeDistribuicaoDFe 下载文档（需要本地 A1 证书）	SEFAZ（mTLS）
NFe	`manifestar_nfe`	通过 NFeRecepcaoEvento 对 NF-e 的接收方进行声明（需要 A1 证书）	SEFAZ（mTLS）
CPF	`validar_cpf`	校验位验证	离线
SPED	`analisar_sped`	分析 EFD/ECD/ECF 文件：期间、公司、错误	离线
SPED	`listar_registros_sped`	按类型筛选记录（C100、E110 等）	离线
eSocial	`listar_eventos_esocial`	可按组筛选的事件目录	离线
eSocial	`validar_evento_esocial`	XML 结构基础验证	离线

🧭 指引工具

返回 URL 和说明——需要手动在政府门户网站上操作。

模块	工具	返回内容
NFSe	`consultar_nfse`	市政 NFSe 门户 URL + 所用系统
证书	`consultar_certidao_federal`	用于签发联邦 CND 的 e-CAC URL
证书	`consultar_certidao_fgts`	用于查询 CRF 的 Caixa 门户 URL

🔐 A1 证书工具（选择启用）

工具 baixar_nfe_distribuicao、manifestar_nfe 和 consultar_status_sefaz 需要数字证书 A1（.pfx/.p12）。所有 SEFAZ Web 服务都要求使用 mTLS 进行传输，包括状态查询——没有证书就无法查询真实状态。

证书和密码绝不会发送到任何外部服务器。
mTLS 身份验证和 XMLDSig 签名均在本地完成。
baixar_nfe_distribuicao 和 manifestar_nfe 将证书路径作为工具本身的参数（本地 .pfx/.p12 文件）。
consultar_status_sefaz（通过 MCP 服务/REST API）使用下方环境变量中配置的证书，并连接到所查询州自己的 Web 服务；如果该州没有自己的基础设施，则连接到虚拟环境（SVRS/SVAN）。
其他工具（通过 BrasilAPI 进行解析、生成 DANFE、签名以及查询 CNPJ/NFe）无需证书。

配置（在 .env 中设置变量，或将其设为部署服务商的密钥——参见 .env.example）：

变量	描述
`NFE_CERTIFICADO_PATH`	挂载到容器中的 `.pfx`/`.p12` 绝对路径
`NFE_CERTIFICADO_SENHA`	证书密码（务必通过密钥管理器提供，绝不要写入已纳入版本控制的 `.env`）
`NFE_EMITENTE_CNPJ`	证书持有人的 CNPJ（14 位数字，可选）
`NFE_AMBIENTE`	`producao` 或 `homologacao`（默认值为 `producao`）

如果未设置 NFE_CERTIFICADO_PATH/NFE_CERTIFICADO_SENHA，consultar_status_sefaz 会抛出 FiscalConfigurationError，HTTP 端点 GET /v1/nfe/status-sefaz 会返回 503——调用方应将此视为“未配置证书”，而不是 SEFAZ 宕机（某个州发生临时网络故障时，仅会跳过该州，不会导致整个调用失败）。GET /v1/fiscal/certificado/status 仅报告是否配置了有效证书（不提供持有人或 CNPJ 信息—— 该端点无需身份验证，因此不得允许识别身份），绝不会泄露证书文件或密码。

☁️ 可选高级数据源：cpfcnpj.com.br（主动启用）

本项目仍然免费、无需注册，且默认不需要 API 密钥。如果您需要企业级的数据覆盖范围和时效性，可以启用 cpfcnpj.com.br 作为主动选择启用的高级数据源，完全不影响默认的免费使用方式。

未配置令牌时，一切照常运行，仅使用免费数据源（BrasilAPI、ReceitaWS 和 Portal NFe）。设置 CPFCNPJ_TOKEN 后，将优先查询该服务，免费数据源则会自动作为备用数据源，整个过程对您透明。

高级数据源为本项目的税务功能增添的内容：

实时官方数据（D+0）： 直接从数据源获取最新登记信息，无需依赖中间数据库的同步周期。
无泄露或抓取的数据库： 数据来自来源明确的官方数据源，而非第三方数据转储。
符合国际认证标准（信息安全认证 ISO/IEC 27001、隐私认证 ISO/IEC 27701 和合规管理认证 ISO 37301），进一步保障隐私并确保妥善处理数据。
支持通过密钥查询 NF-e，这项功能目前依赖不稳定的公共数据源；还新增了免费 API 尚未覆盖的 NFC-e（型号 65）。

启用令牌后可使用高级数据源的工具：

工具	高级数据源	套餐	文档
`consultar_cnpj`	cpfcnpj.com.br	5 或 6	dev/
`consultar_nfe`	cpfcnpj.com.br	100（型号 55）	#op-get-token-100-chave
`consultar_nfce`	cpfcnpj.com.br	102（型号 65）	#op-get-token-102-chave

仅在配置令牌（套餐 102）后，consultar_nfce 才会返回完整的 NFC-e。未配置令牌时，该工具会改用公共数据源，并可能仅返回密钥中的部分数据。套餐 102 的在线覆盖范围包括圣保罗州（SP）和米纳斯吉拉斯州（MG）；其他州需要按需开通，可能返回错误 204（不消耗额度）。覆盖范围详情请参阅 cpfcnpj.com.br/dev/。

配置（均为可选项，参见 .env.example）：

变量	描述	默认值
`CPFCNPJ_TOKEN`	cpfcnpj.com.br 账户令牌。留空 = 禁用高级数据源。	（留空）
`CPFCNPJ_BASE_URL`	高级 API 的基础 URL。仅接受 `https://`（令牌会通过 URL 路径传输）	`https://api.cpfcnpj.com.br`
`CPFCNPJ_CNPJ_PACKET`	CNPJ 套餐：`5`（精简版）或 `6`（完整版）	`6`

请将令牌视为机密信息：使用部署服务提供商的密钥管理器，切勿在生产环境中使用纳入版本控制的 .env 文件。

🧪 实验性工具

需要付费 API 或覆盖范围有限。

模块	工具	限制
CNPJ	`listar_cnpjs_por_nome`	Receita Federal 不提供通过名称搜索的公共 API

🚀 安装

最简单的方式，无需永久安装任何内容：

uvx mcp-fiscal-brasil

什么是 uvx？ 它是 uv 的工具管理器，可在隔离环境中下载并运行 Python 包，不会污染您的系统。如果您还没有安装 uv：curl -LsSf https://astral.sh/uv/install.sh | sh

通过 PyPI 保持更新： 使用 uvx mcp-fiscal-brasil@latest 或 uvx --refresh mcp-fiscal-brasil 强制获取最新版本。uvx 会在本地缓存，因此不使用 @latest 时，您可能会继续使用旧版本。

⚙️ MCP 客户端配置

将以下片段粘贴到客户端的配置文件中。无需 API 密钥。

Claude Desktop

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %APPDATA%\Claude\claude_desktop_config.json（Windows）：

{
  "mcpServers": {
    "fiscal-brasil": {
      "command": "uvx",
      "args": ["mcp-fiscal-brasil"]
    }
  }
}

重启 Claude Desktop。税务和 Agent 工具会自动显示。

Claude Code (CLI)

claude mcp add fiscal-brasil -- uvx mcp-fiscal-brasil

Cursor / `.mcp.json`

创建或编辑 .cursor/mcp.json（或项目根目录中的 .mcp.json）：

{
  "mcpServers": {
    "fiscal-brasil": {
      "command": "uvx",
      "args": ["mcp-fiscal-brasil"]
    }
  }
}

VS Code + Continue

添加到 settings.json：

{
  "continue.mcpServers": {
    "fiscal-brasil": {
      "command": "uvx",
      "args": ["mcp-fiscal-brasil"]
    }
  }
}

Docker

docker run --rm -i \
  -e MCP_FISCAL_LOG_LEVEL=INFO \
  ghcr.io/dehor-labs/mcp-fiscal-brasil:latest

🛠 永久安装（替代方案）

更希望安装一次并将其保留在 PATH 中？

# via pip
pip install mcp-fiscal-brasil

# via uv (recomendado para projetos Python)
uv add mcp-fiscal-brasil

安装后，上面的 JSON 代码片段可使用 "command": "mcp-fiscal-brasil"（无需 uvx）。

从源代码安装

git clone https://github.com/DeHor-Labs/mcp-fiscal-brasil.git
cd mcp-fiscal-brasil
pip install -e .

🔑 环境变量

所有变量均为可选项。服务无需任何配置即可运行。

变量	描述	默认值
`MCP_FISCAL_LOG_LEVEL`	日志级别：`DEBUG`、`INFO`、`WARNING`	`INFO`
`BRASILAPI_BASE_URL`	BrasilAPI 基础 URL（用于自定义环境）	`https://brasilapi.com.br/api`
`HTTP_TIMEOUT`	HTTP 调用超时时间，单位为秒	`30`
`CPFCNPJ_TOKEN`	可选启用的高级服务提供商 cpfcnpj.com.br 的令牌。留空 = 关闭（免费默认设置保持不变）	（留空）
`CPFCNPJ_BASE_URL`	cpfcnpj.com.br 高级 API 的基础 URL。仅接受 `https://`	`https://api.cpfcnpj.com.br`
`CPFCNPJ_CNPJ_PACKET`	cpfcnpj.com.br 上的 CNPJ 套餐：`5` 或 `6`	`6`

使用模式

mcp-fiscal-brasil 有四种使用方式：

模式	适用对象	使用方法
MCP 服务	AI 用户（Claude、Cursor、GPT）	在助手中安装并配置
Python SDK	税务/会计应用开发者	在代码中导入并使用
CLI	运维、本地脚本和自动化	使用 `mcp-fiscal ...`
REST API + Web UI	HTTP 集成和公开演示	使用 `mcp-fiscal-api`

🐍 作为 Python 库使用（SDK）

除了作为 MCP 服务运行外，你还可以直接在 Python 代码中导入和使用，无需服务，也无需额外配置。

快速入门

import asyncio
from mcp_fiscal_brasil import FiscalBrasil

async def main():
    async with FiscalBrasil() as fiscal:
        empresa = await fiscal.consultar_cnpj("00.000.000/0001-91")
        print(empresa["razao_social"])  # Banco do Brasil S.A.
        print(empresa["situacao_cadastral"])  # ATIVA

asyncio.run(main())

离线验证（无需 API，即时完成）

from mcp_fiscal_brasil import FiscalBrasil

fiscal = FiscalBrasil()

# Validações locais - sem chamada de rede
print(fiscal.validate_cpf("529.982.247-25"))       # True
print(fiscal.validate_cnpj("11.222.333/0001-81"))  # True / False
print(fiscal.validate_chave_nfe("3524...44 digitos..."))  # dict com detalhes

与 FastAPI 集成

from fastapi import FastAPI
from mcp_fiscal_brasil import FiscalBrasil

app = FastAPI()
fiscal = FiscalBrasil()

@app.get("/cnpj/{cnpj}")
async def consultar(cnpj: str):
    async with fiscal:
        return await fiscal.consultar_cnpj(cnpj)

与 Django 集成

# views.py
import asyncio
from mcp_fiscal_brasil import FiscalBrasil
from django.http import JsonResponse

def consulta_cnpj(request, cnpj):
    async def buscar():
        async with FiscalBrasil() as fiscal:
            return await fiscal.consultar_cnpj(cnpj)
    dados = asyncio.run(buscar())
    return JsonResponse(dados)

自动登记供应商（ERP 示例）

import asyncio
from mcp_fiscal_brasil import FiscalBrasil

async def cadastrar_fornecedor(cnpj: str, db_session):
    async with FiscalBrasil() as fiscal:
        if not fiscal.validate_cnpj(cnpj):
            raise ValueError("CNPJ inválido")

        dados = await fiscal.consultar_cnpj(cnpj)
        simples = await fiscal.consultar_simples_nacional(cnpj)

        await db_session.execute(
            "INSERT INTO fornecedores (cnpj, razao_social, simples) VALUES (?, ?, ?)",
            [cnpj, dados["razao_social"], simples["optante"]]
        )

批量验证

import asyncio
from mcp_fiscal_brasil import FiscalBrasil

fiscal = FiscalBrasil()

documentos = ["529.982.247-25", "000.000.000-00", "11.222.333/0001-81"]

resultados = [
    {"doc": doc, "válido": fiscal.validate_cpf(doc) or fiscal.validate_cnpj(doc)}
    for doc in documentos
]
# [{'doc': '529.982.247-25', 'válido': True}, ...]

🏗 架构

Claude / GPT / Cursor / qualquer cliente MCP
           |
           | Model Context Protocol (stdio)
           v
    mcp-fiscal-brasil
           |
    +------+-------+--------+--------+--------+-------+--------+
    |      |       |        |        |        |       |        |
   CNPJ   CPF    NFe      NFSe   Simples    SPED  eSocial Certidões
    |      |       |        |        |        |       |        |
    v      v       v        v        v        v       v        v
BrasilAPI  --   SEFAZ   Portais   Receita  Parser  Catálogo  URLs
ReceitaWS       estaduais municipais Federal  local   local  governamentais

数据来源：

BrasilAPI - CNPJ、邮政编码、银行（开源，无需身份验证）
ReceitaWS - CNPJ（备用）
各州 SEFAZ - 服务状态和 NFe 查询
Receita Federal - Simples Nacional 和证明文件（访问指引）

📍 路线图

v0.1.x - CNPJ、CPF、NFe、Simples Nacional 和 SPED 查询；约 14 个 MCP 工具
v0.2.x - 生产级基础设施（_core）、CLI、REST API、Web UI 演示、npm/Node.js 封装和 Agent 工具（合规、尽职调查、税制比较）；约 20 个 MCP 工具
v0.3.x - 离线税务表（NCM/TIPI、CFOP、CST、CEST、州际 ICMS）和 BCB 指数（Selic、IPCA、PTAX、货币调整）；约 36 个 MCP 工具
v0.4.x - 完整的 NF-e 模块（解析、DANFE、XMLDSig 签名、mTLS 分发、收件方声明）和 IBS/CBS 税制改革模拟器（LC 214/2025）；约 42 个 MCP 工具
v0.5.x - 按 NCM 划分的进口模块（II、IPI、PIS/COFINS-importação、含税 ICMS、AFRMM、Siscomex）；NFS-e 熔断器；SPED 和路径注入问题修复；发布自动化；45 个 MCP 工具
v0.6.x - NFC-e modelo 65（DANFE 小票、授权和取消）；按服务提供商/市镇划分的 NFS-e；完整的 NF-e 和 SPED XSD 验证
v0.7.x - 版本化 eSocial（S-1.1）；跨会话持久化缓存；LGPD 审计跟踪
v1.0.0 - 税务套件，具备稳定的 API 合约、扩大的运营覆盖范围和有文档记录的维护 SLA

如何关注进展

发布：点击仓库顶部的 Watch -> Releases，即可在每次发布新版本时收到通知
讨论：github.com/DeHor-Labs/mcp-fiscal-brasil/discussions - 用于提出功能建议、讨论税务和技术问题以及分享使用案例。这里提出的建议会真正纳入路线图
新闻简报：通过 LinkedIn Newsletter MCP Fiscal Brasil 关注带有评论的发布内容 - 每期都会介绍新增内容、修复的问题以及后续计划。立即订阅
Issues：提交包含完整上下文的错误报告（版本、去除真实数据的示例 XML、预期行为与实际行为）

🤝 参与贡献

欢迎贡献！

# 1. Clone o repo ou seu fork
git clone https://github.com/DeHor-Labs/mcp-fiscal-brasil.git
cd mcp-fiscal-brasil

# 2. Instale dependências de desenvolvimento
pip install -e ".[dev]"
pre-commit install

# 3. Crie sua branch
git checkout -b feature/meu-recurso

# 4. Implemente, teste e verifique
python scripts/check_release_metadata.py
ruff check src/ tests/
ruff format --check src/ tests/
mypy src/
pytest

# 5. Abra um Pull Request

查看未解决的 issues - 尤其是标记为 good first issue 的条目。

每个模块都遵循 client.py + schemas.py + tools.py 的模式，因此添加新的税务模块非常简单。

📄 许可证

MIT - 详情请参阅 LICENSE。

为巴西倾注 💚💛
_{将人工智能连接到世界上最复杂的税务体系}

支持 Markdown

登录后评论

基本信息

许可证: MIT
作者: nikolasdehor
语言: python
版本: 0.2.1
传输方式: stdio
收录时间: 2026年3月27日
最近更新: 4 天前
官方 Registry: io.github.nikolasdehor/mcp-fiscal-brasil

报告问题

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

阅读入门指南

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。

Mcp Fiscal Brasil

关于 Mcp Fiscal Brasil

主要功能

适用场景

MCP 相关

配置

工具

详细介绍

快速开始

Claude Desktop

为什么选择 mcp-fiscal-brasil，而不是其他巴西 MCP 服务？

是什么

能自动成交的工作流

🌎 在线演示

✨ v0.2.x 新增内容

为什么要创建这个项目？

🎬 演示

🛠 可用工具

Agent 工具

✅ 可用工具（现可使用）

🧭 指引工具

🔐 A1 证书工具（选择启用）

☁️ 可选高级数据源：cpfcnpj.com.br（主动启用）

🧪 实验性工具

🚀 安装

⚙️ MCP 客户端配置

Claude Desktop

Claude Code (CLI)

Cursor / .mcp.json

VS Code + Continue

Docker

🛠 永久安装（替代方案）

从源代码安装

🔑 环境变量

使用模式

🐍 作为 Python 库使用（SDK）

快速入门

离线验证（无需 API，即时完成）

与 FastAPI 集成

与 Django 集成

自动登记供应商（ERP 示例）

批量验证

🏗 架构

📍 路线图

如何关注进展

🤝 参与贡献

📄 许可证

评论

第一次接触 MCP？

MCP（Model Context Protocol）是什么？

MCP 服务和客户端有什么区别？

本地服务与远程服务怎么选？

如何在 Claude、Cursor 等客户端中安装服务？

收录的项目经过审核吗？“认证”标识代表什么？

我维护的项目已被收录，怎样认领？

Cursor / `.mcp.json`