mcpField
A
aus-accounting-mcp

aus-accounting-mcp

ローカル
duguid.com.au金融データ3今日更新
リポジトリ公式サイト

aus-accounting-mcp について

aus-accounting-mcpは、オーストラリアの会計士、簿記担当者、関連ツールの開発者向けローカルMCPサーバーです。独立して公開される税務・給与計算エンジンをAIアシスタントに提供します。結果には根拠と未解決事項が含まれ、人による確認が必要です。助言や申告には使用できません。

主な機能

  1. 01範囲を限定した税務・年金ワークシート14種類
  2. 02Payday Superの期限とDivision 7A事項の確認
  3. 03ATO基準との比較と合成テストデータの生成
  4. 04ローカルMarkdownから引用付き抜粋を検索
  5. 05台帳への書き込みや申告をせずローカル実行

活用シーン

  1. 01年金拠出の送金・受領期限を示す証拠の確認
  2. 02Division 7A融資レビューや税務ワークシート結果の確認
  3. 03ローカルMarkdownの会計資料と引用の照合

MCP 対応

ローカルstdio MCPサーバーとして動作し、会計計算エンジンとローカルMarkdown検索ツールをAIクライアントに公開します。ツールの処理はローカルですが、接続先のMCPホストは引数と結果をモデル提供元に送信します。

設定

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

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

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

パッケージ
pypiaus-accounting-mcp0.6.0

ツール

18

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

パラメーター型必須説明
yearanyいいえベンチマークデータセットの年。形式は YYYY-YY です（例："2023-24"）。省略または null の場合、最新の同梱データセットを選択し、ATO をリアルタイム検索しません。
limitanyいいえ返す業種の最大数。1〜100 を指定します。簡潔に確認するには 20 を使用してください。省略または null の場合、互換性のため残りの一致項目をすべて返します。
offsetintegerいいえ絞り込み結果における 0 始まりの位置です。0 から開始し、has_more が true の場合は next_offset を渡します。search と year は変更しないでください。
searchanyいいえ任意の大文字小文字を区別しない業種名検索です。省略すると、選択した同梱データセットの全業種を一覧表示します。

詳細

AU Accounting。ATO ベンチマーク、Payday Super、Div 7A をローカルで実行します。そろばんのピクセルアートと、スラブセリフのブロック体で書かれた AU Accounting のワードマーク。

tests Codecov CodeQL Snyk SonarCloud Codacy code quality
OpenSSF Scorecard OpenSSF Best Practices SLSA 3 VirusTotal
licence: FSL-1.1-ALv2 Open in GitHub Codespaces Glama MCP server score

Aus Accounting MCP server

オーストラリアの税務および給与計算のルールを、指定された数値に適用する、独立してリリースされた7つのPythonエンジンに加え、これらのエンジンをAI アシスタントに提供するローカルのModel Context Protocolサーバー、Aus Accounting MCPを提供します。オーストラリアの会計士や簿記担当者、およびそのためのツールを開発する開発者を支援します。 各ツールは、計算結果、その計算に使用した事実、判断を差し控える事項を返します。エンジンと MCP サーバーはローカルで動作します。指定されたファイルを読み取りますが、サービスへの接続、台帳への書き込み、申告の提出は行いません。この範囲の外には、2つの境界があります。MCP ホストはすべてのツール引数と結果をモデルプロバイダーに送信します。また、以下のオプションの LodgeiT アダプターは、有効にした場合に限り、限定された HTTP 呼び出しを行います。不足している事実は不明のままです。Payday Super の行にファンドの受領日が記録されていても、matched_amount または remitted_amount がない場合、ファンドが何かを受領した時期は示されますが、その金額は示されません。そのため、チェッカーは ON_TIME ではなく UNKNOWN とし、必要な金額を明示します（payday-super-checker 0.1.7 の動作です。0.1.6 以前では、その受領記録が SG 金額全額を対象としていると解釈し、その旨を注意書きに記載します）。受領日を記録する際は、ファンドが受け取った金額も必ず入力してください。すべての出力は、利用する前に人が確認してください。

まずはこちら： 各コンポーネントについて · MCP クライアントのセットアップ · ツールのリファレンス · 対象範囲、制限、例

Ryan Duguid は登録済みの税務エージェントでも BAS エージェントでもありません。プロジェクトのサポート対象は、架空のデータで再現できるソフトウェアの問題に限られます。納税者情報を送信したり、税務アドバイス、申告書の作成、税務上の取扱いの確認、申告の提出を依頼したりしないでください。

合成データの例です。会計上の判断はレビュー担当者が行います。

入力： 2026年8月6日が給与支払日のスーパーアニュエーション拠出額 $120 を8月14日に送金し、8月20日時点でファンドの受領証拠がない場合。

1件の拠出を試す

uv をインストールした状態で、合成 CSV をダウンロードし、timely_remittance_no_receipt.csv として保存します。そのフォルダーでターミナルを開き、次を実行します。

uvx --from payday-super-checker==0.1.7 payday-super-check timely_remittance_no_receipt.csv --as-at 2026-08-20 --confirm-remittance-only -o payday-report.csv

これにより、リポジトリをクローンせずに、指定バージョンの PyPI パッケージをダウンロードします。カレントフォルダーに payday-report.csv を作成し、同名のファイルがあれば置き換えます。レポートを開いて、期限日と判定を確認してください。

この確認は受領証拠がないことを認識するものであり、支払いを立証するものではありません。--confirm-remittance-only を省略すると、同じ AT_RISK の結果が終了コード 2 とともに表示されます。これは、その証拠の不足を解決するか、認識するよう求めるものです。

出力： AT_RISK、期限は2026年8月17日。終了コード 0 は、送金のみの証拠を認識したことを示すものであり、期限内の受領を証明するものではありません。

証拠結果人による判断
期限前に送金済み。受領記録なしAT_RISK期限内だったと結論づける前に、ファンドの受領証拠を入手してください。
拠出額 $120 全額のファンド受領が8月17日付で記録されている提供された事実に基づき ON_TIME証拠と、適用される可能性のある期限の例外を確認してください。

Payday Super の5分間ケーススタディを読む · Division 7A 返済ケース · MCP のセットアップ

記録済みの公開評価では、リリース 0.1.3 を使用しています。この過去の実行を再現するには、そこで指定されたリビジョンとコマンドに従ってください。上記の簡易テストでは、ファンドの受領日とともに金額の証拠も必要とするリリース 0.1.7 を使用します。

次の例を選択

作業内容まずはこちら
BAS パックのレビュー想定される指摘を含む 2 つの合成パック
Xero Activity Statement の取引 GST レビューBAS ワークフローと取引手順
月次決算未解決の例外がある、貸借が一致した試算表
GST の計画ブラウザーで使える計画用計算ツール
Division 7A返済に関する主張とレビューの境界
その他のエンジンとエージェントのワークフロー例と再現手順

取引の GST コーディングでは、リンク先の bas-preparation スキルと、同梱の取引リファレンスを読み込んでください。これらは、すべての行を対象にし、供給の税務上の取扱い、購入者の仕入税額控除、BAS への帰属について、それぞれ個別の証拠を求めます。Aus Accounting MCP は取引の GST 分類機能を提供していません。計算や管理勘定の照合だけでは、適切な税務コーディングを立証できません。不足している事実は、権限を持つレビュー担当者が確認するまで未解決のままです。このウォークスルーでは、同等の動作をテスト済みだと主張することなく、Codex、ChatGPT、Copilot への指示ファイルの受け渡し方法を説明します。

インストール、コンポーネントの識別情報、連携、リファレンス

Aus Accounting MCP アプリケーションと、個別にリリースされる 7 つのオーストラリア会計エンジンの開発拠点です。各コンポーネントは、それぞれ独自の配布名、バージョン、ロックファイル、テスト、リリースノート、コマンド、ライセンスを保持しています。ルート配布物、共有ランタイムライブラリ、統一バージョンはありません。

Aus Accounting MCP を使用する

MCP サーバーを使用するには、Python 3.14+ と uv をインストールし、MCP クライアントを次のコマンドを実行するように設定します。

uvx aus-accounting-mcp

これはローカルの stdio サーバーを起動します。Web ページを開くのではなく、MCP クライアントからの接続を待ち受けます。API キーは不要です。パッケージのインストール時に依存関係がダウンロードされますが、その後、ツールは同梱データを使用するため、ネットワークリクエストや記録の書き込みは行いません。接続先の MCP ホストは別の境界です。すべてのツール引数と結果をモデルプロバイダーに送信するため、ホスト型モデルでは架空のデータを使用してください。

uvx は最初にダウンロードしたバージョンを使い続けるため、新しいリリースが自動的に適用されることはありません。リリースを切り替えるには、たとえば PyPI の aus-accounting-mcp==<version> をクライアント設定で指定します。uvx がダウンロードし、以降の起動では uv のキャッシュが消去されるまで、ダウンロードせずにキャッシュされたコピーを再利用します。

合成 BAS 出力と Division 7A ローンレビューを示す静的なターミナルデモ

接続したら、アシスタントに平易な英語で質問してください。次の架空のリクエストは、それぞれ 1 回のツール呼び出しに対応します。

質問ツール
「売上が $180,000、その他の収入なし、賃金が $60,000、家賃が $30,000、その他の経費が $40,000 の美容師について、ATO のベンチマークと比較してください。」get_ato_benchmarks
「2026 年 8 月 6 日の給与支払日のスーパーが $120 で、8 月 14 日に送金されました。8 月 20 日時点で期限内ですか？」calc_payday_super_deadline
「2026-27 年の Division 7A ベンチマーク金利はいくらですか？」get_div7a_benchmark_rate
「TFN を提出し、非課税基準額を申告した従業員（スケール 2）に、2026-27 年に週あたり定額の賃金 $1,000 を支払います。控除、ローン、賞与、その他の調整はありません。源泉徴収する PAYG はいくらですか？」calculate_tax_worksheet

クライアントの設定と使用例 · ツールリファレンス · PyPI · Glama の掲載ページ

ツールでは、ATO のベンチマーク業種の一覧表示、指定された経費区分の比較、Payday Super の時期の確認、レビュー済み Division 7A 金利の照会、利用者が提供した Division 7A ローンの確認、対応範囲外の Division 7A に関する事項の拒否、合成 CTR/BAS フィクスチャの生成を行います。また、関連する Payday 拠出を評価し、範囲を限定した税金・スーパーのワークシートを 14 種類計算し、引用付きのローカル Markdown 抜粋を取得します。Division 7A のレビューは、委任されたエンジンの s 109N/s 109E の範囲に限定されます。統合ローンの作成や、s 109R に基づく返済の分類は行いません。出力はレビューの補助であり、助言や申告書の提出を目的とするものではありません。

編集可能なソースをインストールするには、apps/aus-accounting-mcp/ から pip install -e . を実行します。リポジトリのルートはインストール可能な Python パッケージではありません。

コンポーネント

パス配布名インポートパッケージコマンド
packages/australian-tax-calculators/australian-tax-calculators (Rust)なしaustralian-tax-calculators (JSON stdin ワークシート)
apps/aus-accounting-mcp/aus-accounting-mcpaus_accounting_mcpaus-accounting-mcp、aus-accounting-mcp-demo
packages/ato-benchmark-compare/ato-benchmark-compare (Rust)なしato-benchmark-compare
packages/payday-super-checker/payday-super-checker (Rust)なしpayday-super-check
packages/div7a-loan-review/div7a-loan-review (Rust)なしdiv7a-loan-review
packages/the-exchequer-tally/the-exchequer-tally (Rust)なしthe-exchequer-tally
packages/solomons-sword/solomons-sword (Rust)なしsolomons-sword
packages/the-wip-tally/the-wip-tally (Rust)なしwip-tally
apps/au-accounting/au-accounting (Rust)なしau-accounting、Rust エンジンごとに 1 つのサブコマンド
packages/gst-review/gst-review (Rust)なしgst-review：登録状況に照らした GST コーディング状態の確認と、BAS と元帳の照合
packages/lodgment-calendar/lodgment-calendar (未リリース)lodgmentcalendarPython 関数：BAS、IAS、所得税申告書に関する ATO 申告プログラムの期限。事実が不足している場合は UNKNOWN
apps/lodgeit-calculator-adapter/lodgeit-calculator-adapter (Rust、未リリース)なしlodgeit-adapter：サードパーティーの計算サービス用オプションアダプター。デフォルトでは無効で、有効にした場合のみ HTTP 呼び出しを実行します（LODGEIT_ADAPTER_ENABLED=1 または --enable-network）
packages/au-tax-rates-data/au-tax-rates-data (Rust、未リリース)なしrates validate、snapshot、check、ato-tables：原文の引用をそのまま含む ATO 税率と基準値を、オフラインで検証します

IMPORTS.md には、インポートされた各コンポーネントのソースリポジトリ、コミット、ツリーが記録されています。 MCP アプリケーションは io.github.ryanduguid/aus-accounting MCP Registry サーバーであり、公開済みの ato-benchmark-compare、payday-super-checker、div7a-loan-review、australian-tax-calculators、gst-review の各配布パッケージに依存しています。開発ワークスペースでは、uv は PyPI から Python の最終リリースである gst-review 0.1.0、australian-tax-calculators 0.2.0、div7a-loan-review 0.3.2、ato-benchmark-compare 0.2.2、payday-super-checker 0.2.2 を使用します。

uv ワークスペースでは、引き続き Python エンジンとアプリケーションを開発しています。MCP サーバーでは、まだ Rust クレートを使用していません。

Rust エンジンをインストールする

8 つの Rust エンジンは、単体バイナリとして未リリースです。 Rust 1.99 以降を使用して、エンジンごとに 1 つのサブコマンド（benchmarks、div7a、exchequer、payday-super、gst-review、solomons、tax、wip）を持つ au-accounting をインストールします。

cargo install --locked --git https://github.com/ryanduguid/australian-accounting au-accounting

au-accounting div7a --help を実行すると、そのエンジン固有のコマンドが表示されます。詳しくはREADMEを参照してください。代わりに各エンジン固有のコマンドをインストールするには、上の表にあるクレート名を指定します。たとえば次のとおりです。

cargo install --locked --git https://github.com/ryanduguid/australian-accounting div7a-loan-review

au-accounting gst-review review-coding と reconcile-bas は stdin から JSON を読み込みます。GST Review のスキーマを参照してください。

ビルド済みバイナリは近日公開予定です。CI ではすでに各クレートの Windows、macOS、Linux 向けアーカイブをビルドしており、各クレートにはリリースアセットを指定する cargo-binstall メタデータが含まれています。現時点では、まだどのリリースでも公開されていません。Rust バイナリ用の Release Policy ワークフローと、crates.io へのクレート公開を待っているためです。両方が公開されると、コンパイルせずにビルド済みバイナリをダウンロードできるようになります。

cargo binstall au-accounting

コンポーネントで作業する

コンポーネントのディレクトリに移動し、そのコンポーネント独自の README.md、 AGENTS.md、または CONTRIBUTING.md に記載されたコマンドを使用してください。ルートの CONTRIBUTING.md には、 共通のコマンドと、それらを実行するルートのワークフローが記載されています。

ローカル環境のセットアップを省略するには、GitHub Codespaces でリポジトリを開いてください。 devcontainer は uv をインストールし、uv sync --locked を実行するため、上記の架空の例を 記載どおりに実行できます。Codespaces の使用量は、ご自身の GitHub クォータに加算されます。

境界

  • MCP アプリケーションは、公開済みのディストリビューションを通じてのみエンジンに依存します。
  • エンジンが aus_accounting_mcp や別のエンジンをインポートすることはありません。また、本番モジュールで パッケージの外に出る相対インポートは使用されません。どちらも tests/test_boundaries.py で検証されています。
  • 有効なのはルートの .github/workflows/ 内にあるワークフローのみです。コンポーネントのディレクトリにはワークフローがありません。
  • クライアントデータ、認証情報、生成されたクライアントレポートをこのリポジトリに含めることはありません。

リリース

各コンポーネントは、それぞれのルートワークフロー .github/workflows/release-<component>.yml によって、 名前空間付きタグ <component>/vX.Y.Z で個別にリリースされます。このワークフローは、そのコンポーネントのディレクトリのみを対象とする 固定バージョンの Release Policy 再利用可能ワークフローを呼び出します。表は CONTRIBUTING.md にあります。 packages/au-tax-rates-data/ の税率データセットはリリースされません。

各コンポーネントの LICENSE はそのコンポーネントに適用されます。また、 packages/ato-benchmark-compare/NOTICE と packages/au-tax-rates-data/NOTICE は、ATO の資料を対象としています。 出力はレビューの補助資料であり、助言ではありません。

ソロモン・グランディは月曜日に生まれ、日曜日に照合を終えました。
オーストラリア、ニューカッスルでRyan Duguidが制作。

コメント

Markdown 対応

MCP は初めてですか？

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

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