Mcp Fiscal Brasil

ローカル

dehor-labs.github.io金融データ3975 日前に更新

Mcp Fiscal Brasil について

Mcp Fiscal Brasilは、AIアシスタント、ERP、CRM、社内自動化向けのブラジル税務・企業データ用Python MCPサーバーです。オンライン照会に加え、オフラインの文書解析・検証、組み込み参照テーブル、高度なコンプライアンスワークフローを提供し、標準ではアカウントやAPIキーを必要としません。

主な機能

01CNPJ、CPF、Simples Nacionalの照会
02NF-e XMLの解析・検証とDANFE生成
03SPEDとeSocialのオフライン分析
04NCM、CFOP、CNAEの参照テーブルを内蔵
05サプライヤーリスク評価と企業一括処理
06任意のA1証明書によるSEFAZ操作

活用シーン

01サプライヤーの税務コンプライアンスとリスクの確認
02NF-eデータの検証やDANFE PDFの生成
03SPEDファイルの要約と不整合の検出
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 はインストール済みバージョンをキャッシュします。最新の PyPI バージョンを強制的に使用するには、uvx mcp-fiscal-brasil@latest または uvx --refresh mcp-fiscal-brasil を使用してください。

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サーバーではなく、mcp-fiscal-brasilを選ぶ理由

機能	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でキーが必要）	はい
高度なエージェント向けツール	はい（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、納税証明書、サプライヤーのデューデリジェンス に接続します。

汎用的な公開データのカタログを目指しているわけではありません。製品の特定領域に特化し、断片化した税務情報の照会を 安全で組み合わせ可能な、エージェント向けのツール にすることを目指しています。

導入につながるワークフロー

ワークフロー	主なツール	結果
サプライヤーのデューデリジェンス	`risk_score_supplier`	0～100 のスコア、リスク、要因、契約に関する推奨事項
一括トリアージ	`consultar_empresas_lote`	1 回の呼び出しで複数の CNPJ を処理し、企業ごとにコンプライアンス情報とスコアを取得
CNPJ コンプライアンス	`analyze_cnpj_compliance`	CNPJ、Simples／MEI、CNAE を実行可能なレポートにまとめます
NFe の検証	`validate_nfe_full`	XML、キー、発行者を検証し、問題を構造化して提示
SPED の要約	`summarize_sped`	エグゼクティブサマリー、期間、企業、ブロック、不整合
税務計画	`compare_tax_regimes`	MEI、Simples、推定利益課税、実利益課税を比較

🌎 ライブデモ

ホスト型 Web UI デモです（Render の無料プランを利用しており、初回アクセス時は起動まで 30 秒ほどかかる場合があります）。

上のボタンをクリックすると、Render.com で 3 クリックするだけで独自のインスタンスをホストできます。

その他の方法（Fly.io、Docker によるセルフホスト）については、docs/getting-started/deploy.md をご覧ください。

✨ v0.2.x の新機能

4 つの領域を強化したバージョンです。

8 つの新しいデータソース：CNAE、CPF、Simples Nacional、MEI、IBGE、CEP、統合企業情報、納税証明書
エージェント向けツール（高レベル）：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 アシスタントに接続するだけで、自然言語で質問を始められます。サーバーがすべてを処理し、Receita Federal、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.

🛠 利用可能なツール

税務情報を扱う低レベルのツールと、業務上の意思決定を支援する高レベルのエージェント向けツールを利用できます。

エージェント向けツール

ツール	使用する場面
`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`	チェックディジットを検証し、州、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（mod 55）の XML から DANFE PDF（A4）を生成	オフライン
NFe	`validar_assinatura_nfe`	XMLDSig 署名を検証し、証明書データを抽出	オフライン
NFe	`consultar_status_sefaz`	NfeStatusServico4 を介して州ごとの SEFAZ ウェブサービスの実際のステータスを確認（証明書 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）が必要です。mTLS は、ステータス照会も含むすべての SEFAZ ウェブサービスで必須の通信要件です。証明書なしで実際のステータスを照会する方法はありません。

証明書とパスワードが外部サーバーに送信されることはありません。
mTLS 認証と XMLDSig 署名はローカルで行われます。
baixar_nfe_distribuicao と manifestar_nfe には、ツールのパラメーターとして証明書のパス（ローカルの .pfx／.p12）を渡します。
consultar_status_sefaz（MCP サーバー／REST API 経由）では、以下の環境変数で設定された証明書を使用し、照会対象の州（UF）独自のウェブサービス、またはその州に独自のインフラがない場合は仮想環境（SVRS／SVAN）に接続します。
その他のツール（解析、DANFE、署名、BrasilAPI 経由の 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

consultar_nfceは、トークンが設定されている場合（パッケージ102）のみ、完全なNFC-eを返します。トークンがない場合は公開ソースを使用し、キーの一部のデータのみを返すことがあります。パッケージ102のオンライン対応地域はサンパウロ州（SP）とミナスジェライス州（MG）です。その他の州（UF）は個別の有効化が必要で、エラー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 を再起動します。税務およびエージェント関連のツールが自動的に表示されます。

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`	プレミアム API cpfcnpj.com.br のベース URL。`https://` のみ使用できます	`https://api.cpfcnpj.com.br`
`CPFCNPJ_CNPJ_PACKET`	cpfcnpj.com.br の CNPJ パッケージ：`5` または `6`	`6`

使用モード

mcp-fiscal-brasil は 4 つの方法で動作します：

モード	対象	方法
MCP Server	AI ユーザー（Claude、Cursor、GPT）	アシスタントにインストールして設定します
SDK Python	税務・会計アプリの開発者	コードにインポートして使用します
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、CEP、銀行（オープンソース、認証不要）
ReceitaWS - CNPJ（フォールバック）
各州の SEFAZ - サービス状況および NFe の照会
連邦歳入庁 - Simples Nacional および証明書（アクセス方法の案内）

📍 ロードマップ

v0.1.x - CNPJ、CPF、NFe、Simples Nacional、SPED の照会；MCP ツール約 14 個
v0.2.x - 本番環境対応のインフラ（_core）、CLI、REST API、Web UI デモ、npm/Node.js ラッパー、エージェント型ツール（コンプライアンス、デューデリジェンス、税制比較）；MCP ツール約 20 個
v0.3.x - オフライン税務テーブル（NCM/TIPI、CFOP、CST、CEST、州間 ICMS）と BCB 指標（Selic、IPCA、PTAX、金額補正）；MCP ツール約 36 個
v0.4.x - NF-e 完全モジュール（解析、DANFE、XMLDSig 署名、mTLS 配信、受取人による意思表示）および税制改革シミュレーター IBS/CBS（LC 214/2025）；MCP ツール約 42 個
v0.5.x - NCM による輸入モジュール（II、IPI、PIS/COFINS 輸入税、グロスアップ ICMS、AFRMM、Siscomex）；NFS-e サーキットブレーカー；SPED とパスインジェクションの修正；リリース自動化；MCP ツール 45 個
v0.6.x - NFC-e モデル 65（レシート形式 DANFE、認可とキャンセル）；プロバイダー／自治体別 NFS-e；NF-e と SPED の完全な XSD 検証
v0.7.x - バージョン管理された eSocial（S-1.1）；セッション間の永続キャッシュ；LGPD 監査証跡
v1.0.0 - 安定した API 契約、拡充された運用範囲、文書化された保守 SLA を備えた税務スイート

🤝 コントリビューション

コントリビューションを歓迎します！

# 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

オープン中の Issueをご覧ください。特に good first issue のラベルが付いたものを歓迎します。

各モジュールは client.py + schemas.py + tools.py のパターンに従っているため、新しい税務モジュールを簡単に追加できます。

📄 ライセンス

MIT - 詳細は LICENSE をご覧ください。

ブラジルのために 💚💛 を込めて作成
_{人工知能を世界で最も複雑な税務システムにつなぎます}

Markdown 対応

ログインしてコメント

基本情報

ライセンス: MIT
作者: nikolasdehor
言語: python
バージョン: 0.2.1
トランスポート: stdio
掲載日: 2026年3月27日
最終更新: 5 日前
公式 Registry: io.github.nikolasdehor/mcp-fiscal-brasil

問題を報告

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

入門ガイドを読む

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。

Mcp Fiscal Brasil

Mcp Fiscal Brasil について

主な機能

活用シーン

MCP 対応

設定

ツール

詳細

クイックスタート

Claude Desktop

他のブラジル向けMCPサーバーではなく、mcp-fiscal-brasilを選ぶ理由

概要

導入につながるワークフロー

🌎 ライブデモ

✨ v0.2.x の新機能

このプロジェクトが生まれた理由

🎬 デモ

🛠 利用可能なツール

エージェント向けツール

✅ 実用的なツール（今すぐ使用可能）

🧭 案内ツール

🔐 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`