fiscocheck

fiscocheck

fiscocheck は、イタリアの税務ユーティリティを集めたホスト型 imperioutils fisco-it MCP サーバーへの、小規模なローカルブリッジです。エージェントはこれを通じて、codice fiscale の確認と生成、partita IVA、IBAN、PEC アドレスの検証、CAP や ATECO コードの検索、一般的な計算（regime forfettario、IVA、reverse charge、split payment、IMU）の実行、FatturaPA ドキュメントの解析、呼び出し元がすでに計算した金額からの F24 フォームの行の作成、Intrastat の報告頻度と構成の確認、NIS2 の参照データの読み取り、受取人の確認、guardian のサプライヤーチェックの実行ができます。上流のツール説明はイタリア語で、このブリッジは取得時のまま翻訳せずに提供します。

このブリッジは税務テーブルを独自には保持しません。ツール一覧は稼働中のエンドポイントから取得したとおりにローカルで返し、各ツール呼び出しを上流に転送して、返された内容を変更せずに返します。このインターフェース上のツールは、申告の提出も支払いの実行もしません。F24 と Intrastat の作成ツールは、呼び出し元が指定した行からドキュメントを組み立て、guardian ツールは呼び出し元が指定したサプライヤーデータ（IBAN、partita IVA、codice fiscale のチェックサム、および EU VIES 公開レジスター）を確認します。

ツール

28 個のツールを分野別に分類しています。

• 識別子：validate_codice_fiscale、 generate_codice_fiscale、validate_partita_iva、 validate_iban、validate_pec。
• 検索：lookup_cap、lookup_ateco、 search_ateco。
• 計算：calc_forfettario、calc_iva、 calc_reverse_charge、calc_split_payment、 calc_imu。
• ドキュメント：parse_fatturapa、 parse_verify_fatturapa、compose_f24。
• Intrastat：intrastat_periodicity、 intrastat_compose、intrastat_reference。
• NIS2：nis2_tipologie、nis2_ambito、 nis2_reference。
• 受取人と guardian：verify_payee、 guardian_list_suppliers、 guardian_supplier_ledger、 guardian_supplier_status、guardian_check_iban、 guardian_watch_supplier。

5 つのツール（calc_imu、intrastat_reference、 nis2_tipologie、nis2_reference、verify_payee）は空の required: [] リストを持つ状態で取得され、3 つの guardian ツール（guardian_list_suppliers、 guardian_supplier_ledger、 guardian_supplier_status）は required キー自体がない状態で取得されました。どちらの形式もそのまま提供します。元のレジストリ記録によると、23 個のツールは無料で、5 個の guardian ツールがキー必須のセットです。

設定

• IMPERIOUTILS_MCP_URL（任意） — 上流エンドポイントを上書きします。デフォルトは https://imperioutils.com/api/mcp です。（上書き用フックは、この再構築で独自に付加したことを明記したものです。）
• IMPERIOUTILS_API_KEY（任意） — 設定すると、呼び出し元自身の imperioutils API キーを使い、すべての上流リクエストに X-API-Key: <key> ヘッダーを付加します。設定されていない場合、キーのヘッダーは送信されません。（ヘッダー名は元のレジストリ記録で確認されています。記録にはパッケージの環境変数名がないため、この環境変数からキーを転送する動作は、再構築で独自に付加したことを明記したものです。元のインターフェースはキーなしで取得されました。）

転送の仕組み

最初のツール呼び出し時に、クライアントは上流とのストリーミング可能な HTTP セッションを開きます。まず JSON-RPC の initialize リクエスト（protocolVersion 2025-03-26、clientInfo の name は fiscocheck）を送り、次に notifications/initialized 通知を送り、その後、呼び出し元の引数を変更せずに含めた tools/call リクエストを送ります。上流が initialize に Mcp-Session-Id ヘッダーを付けて応答した場合、その値はセッション内の以降のすべてのリクエストに付加され、プロセスが存続する間、セッションが再利用されます。応答は通常の JSON またはサーバー送信イベントとして届く場合があり、どちらも読み取ります。

上流からの成功結果は、上流が設定した isError フラグも含め、そのまま通過します。JSON-RPC エラー、2xx 以外のステータス、読み取り不能な応答、または完了できないリクエストといった失敗は、テキストが fiscocheck error: で始まる isError 結果として返されます（このエラー表示は、この再構築で独自に付加したことを明記したものです）。

CLI

各ツールは、1 つの JSON 引数文字列を受け取るサブコマンドでもあります。

npx @reneturcios/fiscocheck validate_iban '{"iban":"IT60X0542811101000000123456"}'
npx @reneturcios/fiscocheck validate_codice_fiscale '{"codice_fiscale":"RSSMRA80A01H501U"}'
npx @reneturcios/fiscocheck calc_imu '{}'
npx @reneturcios/fiscocheck --version

終了コード：成功時は 0、isError の結果の場合は 1、使用方法に誤りがある場合は 2 です。

MCP サーバー

npx -y @reneturcios/fiscocheck mcp

MCP クライアントの設定：

{
  "mcpServers": {
    "fiscocheck": {
      "command": "npx",
      "args": ["-y", "@reneturcios/fiscocheck", "mcp"]
    }
  }
}

Docker

docker run -i ghcr.io/cloudcorprecords/fiscocheck
docker run --rm ghcr.io/cloudcorprecords/fiscocheck --version

コンテナのデフォルトコマンドは mcp であるため、最初の形式では stdio MCP サーバーとして動作します。それ以外の引数は通常どおり CLI に渡されます。

開発

npm install
npm run build
npm test
npm run dev

テストスイートはすべてスタブ化された JSON-RPC アップストリームに対して実行され、実際のネットワーク呼び出しは行いません。

ライセンス

MIT — LICENSE を参照してください。