METHOD A / MCP
GnuCashを
直接読み取る
MCP操作で対象年度の仕訳行を取得し、元帳そのものを成果物に含めます。取得範囲と借貸一致を検算しやすい構成です。
- 概要
- 総勘定元帳
- 勘定別集計
- 消費税比較
- 検算
- 出典・注意事項
01 / PROJECT OVERVIEW
同じ帳簿から、
2つの作成方法を比べます。
対象は2016〜2025年度。GnuCashの元データをMCP経由で直接読み取る方法と、GnuCashから出力した総勘定元帳を読み込む方法で、年度別の税務申告準備データを作成しました。
GnuCashを
METHOD B / LEDGER IMPORT
出力済み元帳を
AIで整理する
GnuCashの総勘定元帳を読み込み、取引明細へ整形してから税務区分を付与します。MCPを使わない比較用の作成方法です。
- 税務前提
- 取引明細
- 勘定集計
- 消費税比較
- 概要
- 検算
- 出典・注意事項
02 / MCP DOWNLOAD & SETUP
GnuCash向けMCPを取得し、
GnuCashへ接続します。
ninetails-ioが公開する「gnucash-mcp」は、AIアシスタントからローカルのGnuCash帳簿を読み書きするための第三者製MCPサーバーです。GnuCash公式プロジェクトが提供・認定するものではありません。最初はサンプル帳簿または作業用コピーで接続を確認してください。
THIRD-PARTY REPOSITORY
ninetails-io / gnucash-mcp
Gitで取得する場合は下記コマンドを使います。ZIPで取得する場合も、保存されるファイル名は英語名の gnucash-mcp-main.zip です。
git clone https://github.com/ninetails-io/gnucash-mcp.git-
01
PREPARE
必要なものを用意
GnuCash、Codex、GitまたはZIP展開環境、Pythonパッケージ実行ツールの
uvを用意します。 -
02
BOOK FORMAT
帳簿をSQLite形式へ
MCPが直接扱えるのはSQLite3形式です。XML形式の帳簿は、GnuCashの「名前を付けて保存」でデータ形式をSQLite3にし、元ファイルも残します。
-
03
REGISTER
CodexへMCPを登録
CodexのMCP設定へ、下記のコマンド・引数・環境変数を登録します。フォルダーと帳簿は必ず絶対パスで指定します。
-
04
VERIFY
再起動して接続確認
Codexを再起動し、MCP接続を確認します。最初は残高や勘定一覧などの読み取りから試し、実データへの書き込みは内容を確認してから行います。
CODEX / MCP SERVER VALUES
登録する3つの値
次の例にある2か所のパスを、ご自身の環境に合わせて置き換えてください。
- Command
uv- Arguments
run --directory C:\path\to\gnucash-mcp gnucash-mcp --modules=all- Environment
GNUCASH_BOOK_PATH=C:\path\to\your-book.gnucash
導入方法・対応形式・安全機能の詳細は、プロジェクトREADMEで最新情報をご確認ください。
03 / WORKFLOW
読み取る。分ける。
比べて、確かめる。
AIに計算を任せきるのではなく、入力元・税務前提・計算結果・検算を分離し、後から人が追跡できる順序でExcelにまとめています。
- 01
INPUT
年度ごとの取引を取得
GnuCashデータまたは総勘定元帳から、対象期間の仕訳を抽出します。 - 02
CLASSIFY
勘定と税区分を整理
課税売上、課税仕入、給与、減価償却、租税公課、固定資産を分けます。 - 03
CALCULATE
実額とみなしを比較
税込金額から税額を概算し、第5種事業・みなし仕入率50%と比較します。 - 04
VERIFY
元帳と計算を検算
借方・貸方、抽出件数、課税売上、固定資産、算式の一致を確認します。
04 / OUTPUT WORKBOOKS
結果だけでなく、
根拠まで残します。
2025年度のMCP版では1,128仕訳行、元帳読込版では564取引行を対象にし、どちらも同じ売上・損益・消費税概算へ到達しました。
GnuCash MCPで読み取った仕訳と、その集計結果を同じファイル内で追跡できます。
元帳から抽出した取引に税区分を付け、前提と集計結果を分けて確認できます。
05 / 2025 COMPARISON
2つの経路で、
同じ数字を確認。
2025年度の例では、MCP版と元帳読込版の双方で主要集計が一致しました。表示額は学習用の架空データに基づく概算です。
CHECK 実額計算のほうが、みなし計算より約27,273円低い結果
- 当期売上高
- 61,000,000円・税込
- 帳簿上の当期損益
- −600,000円
- 消費税等・実額計算
- 2,745,455円・概算
- 消費税等・第5種みなし
- 2,772,727円・概算
06 / TAX BASIS
計算条件を、
先に固定します。
AIが自動で制度を決めたのではなく、検証条件として与えた前提を明示し、その前提に沿って比較計算しています。
取引はすべて税込
取引日ごとの標準税率を使い、税込額から税額を概算します。
固定資産は控除対象外
固定資産の取得は、指定条件により仕入税額控除へ含めません。
第5種事業として比較
みなし仕入率50%で、実額方式との納付税額差を表示します。
検算と出典を収録
抽出件数、借貸一致、税額算式、未分類取引などの確認欄を設けています。
07 / DOWNLOADS
10年度分を、
作成方法ごとに確認できます。
ダウンロード用ファイルは、環境依存を避けるためすべて英語名に統一しています。Excel内の表示は日本語です。
MCP METHOD
GnuCash MCP版
全年度をZIPでダウンロードLEDGER IMPORT METHOD