mcpField
S
Simples Nacional

Simples Nacional

ローカル
github.com/vitorantoniazzi金融データ08 週間前に更新

Simples Nacional について

ブラジルの会計担当者や企業向けに、Simples Nacional の税額を計算する MCP サーバーです。DAS と制度外の負担を区別し、売上区分による差額も算出します。

主な機能

  1. 01月次 DAS と実効税率の計算
  2. 02Fator R による付表判定
  3. 03業種別の特別税制の確認
  4. 04DAS 対象外の負担の特定
  5. 05売上未区分による過払いの算定
  6. 06付表別の総負担比較と累積控除額の算定

活用シーン

  1. 01企業の月次 DAS の見積もり
  2. 02サービス業の Anexo III または V の判定
  3. 03Anexo IV の追加雇用主負担の確認
  4. 04単相課税または ICMS-ST 売上の過払い算定

MCP 対応

MCP サーバーは、DAS 計算、付表比較、累積税額控除の算定など、Simples Nacional 向けの七つの税計算ツールをクライアントに提供します。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
"mcpServers": {
"vitorantoniazzi-simples-nacional": {
"command": "uvx",
"args": [
"simples-nacional-mcp"
]
}
}
}
起動コマンドuvx simples-nacional-mcp

ローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
pypisimples-nacional-mcp0.3.1

ツール

7

掲載時のツール一覧 · 3 週間前に更新

パラメーター型必須説明
anexoenumはいI | II | III | IV | V
rbt12anyいいえ
receita_do_mesanyはい
receita_acumuladaanyいいえ
incluir_reparticaobooleanいいえ
meses_de_atividadeanyいいえ

詳細

simples-nacional-mcp

Simples Nacional の計算を行う MCP サーバーです。ツールは7つあり、法律に基づく税率表と、よくある誤った結論を防ぐためのツールが2つあります。

pip install simples-nacional-mcp

なぜ作られたのか

Simples の企業がいくら税金を払うかアシスタントに尋ねると、実効税率を計算します。しかし、それは税負担ではなく、DAS の負担です。この違いは微妙なものではありません。

  • Anexo IV の DAS には、雇用主負担金が含まれません。給与総額の20%に加えてRATがかかり、別途納付します。税率だけを見ると、Anexo IV は Anexo III より安く見えます。実際はそうではありません。
  • sublimite のR$ 3,6 miを超えると、ICMSとISSがDASから外れるため、DASの税率は下がります。税負担が下がるのではなく、分割されるのです。
  • monofásica の売上や ICMS-ST の対象となる売上は、サプライチェーン内の立場によって逆方向に計算が変わります。製造者は集中課税分を別途納付し、再販売者は売上を区分してDASを減らします。

carga_fora_do_das ツールは、アシスタントが端数のない誤った数字を出すのではなく、こうした点を説明できるようにするためのものです。

ツール

ツール回答する内容
calcular_das月ごとのDAS、実効税率、税率帯、DASに含まれる税、sublimiteと制度離脱のフラグ。rbt12、または13か月未満の企業向けに receita_acumulada + meses_de_atividade を指定できます
resolver_anexo_fator_rFator Rに基づくAnexo IIIまたはV、比率と規則
ressalvas_setoriais特別制度の対象となる業種:アルコール飲料と冷たい飲料、医薬品、化粧品、自動車部品、タイヤ、燃料
carga_fora_do_das税率に含まれないものと、各項目が税負担を増やすか減らすか
quantificar_segregacaomonofásicaまたはICMS-STの売上を区分しないことで、いくら余分に支払うことになるか
comparar_anexos5つの付属表を総負担で比較。Anexo IVでDASの対象外となるCPPを加算します
indebito_acumulado複数の納付期間にわたる過誤納金を、時効にかかった分と分けて算出します

誰も計算しない金額

Anexo Iのバー、RBT12がR$ 900 mil、月間売上がR$ 80 milで、そのうちR$ 60 milがビールの場合:

売上を区分しない場合のDASR$ 6.560,00
売上を区分した場合のDASR$ 4.149,20
余分に支払った額R$ 2.410,80/月

DASの37%に相当し、年間ではほぼR$ 29 milです。この金額は還付請求できます。ビールはPIS/COFINSのmonofásica対象であり、ICMS-STの対象でもあるため、この税率帯の税率の49%は、サプライチェーンですでに納付された税金に相当します。

quantificar_segregacao がこれを計算します。sublimiteを超えた場合は、ICMSがすでにDASに含まれていないため、ICMS-STの売上を区分しても変化がないことを通知します。

数値で見るAnexo IVの落とし穴

RBT12がR$ 1 milhão、月間売上がR$ 80 mil、給与総額がR$ 30 milの場合:

付属表DASの税率別途納付するCPP総負担
III12,44%—12,44%
IV10,02%R$ 6.30017,90%

comparar_anexos はDASの対象外となる金額を加算し、総負担による順位と税率による順位が逆転すると警告します。上記がその例です。給与総額が指定されていない場合は、Anexo IVの負担を過小評価する比較になると通知します。

還付可能な金額

indebito_acumulado に各納付期間を渡すと、合計額を返し、5年間の期限内にある分を分けて表示します。

直近の20納付期間R$ 48.216,00 還付可能
2019年の2納付期間R$ 4.821,60 時効

CTN第168条に基づく期限です。納付期限の計算では、DASの納期限を支払日の基準として使用します。行政上の請求では期限は中断されません。

Claude Codeへのインストール

claude mcp add simples-nacional -- simples-nacional-mcp

Claude Desktopへのインストール

claude_desktop_config.json 内で:

{
  "mcpServers": {
    "simples-nacional": {
      "command": "simples-nacional-mcp"
    }
  }
}

例

RBT12がR$ 1 milhão、給与総額がR$ 250 milのサービス企業の場合、どの付属表になり、いくら支払いますか?

アシスタントはFator Rを算出し(25%で28%を下回るため、Anexo V)、DASを計算します。税負担について尋ねられると、carga_fora_do_das を呼び出します。Anexo Vでは空のリストが返され、税率が実際に税負担を表していることが確認できます。Anexo IVの事業に切り替えると、同じ質問に対して別途納付するCPPが返されます。

対応していないこと

  • carga_fora_do_dasは定量化しません。 対象外となるものとその方向を示します。数値を確認するには、税目ごとのDASの配分に基づいて計算するquantificar_segregacaoを使用してください。
  • 活動内容を分類しません。 CNAEの付属表を特定する判断は、会計上の判断です。
  • 税務アドバイスではありません。 誰も注意を促さなければ、アシスタントが結果を助言として伝えてしまうため、各ツールの説明で繰り返し明記しています。

計算処理の場所

simples-nacional(PyPI)にあります。そこでは、LC 123/2006の表が転記され、独立した別の転記内容との照合テストが行われています。ここにあるのはインターフェースのみです。法律の内容を二か所に重複して持たせていません。

ライセンス

MIT

コメント

MCP は初めてですか?

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

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