Metadata-Version: 2.4
Name: jp-invoice-tax-mcp
Version: 0.1.0
Summary: 日本の請求・税務ユーティリティ MCP サーバー（消費税/源泉徴収/適格請求書番号のチェックディジット検証/税率別区分集計/和暦西暦変換/請求書生成）
Project-URL: Homepage, https://panda-hq-7af784ab.pages.dev
Author: panda studio
License: MIT
License-File: LICENSE
Keywords: invoice,japan,japanese,mcp,model-context-protocol,tax,インボイス,和暦,消費税,源泉徴収,適格請求書
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: Japanese
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.10
Requires-Dist: mcp>=1.0
Description-Content-Type: text/markdown

# JP Invoice & Tax MCP — 日本の請求・税務ユーティリティ MCP

Claude Desktop などの AI アシスタントから使える、**日本の実務に特化した MCP サーバー**です。
消費税・源泉徴収の計算、**適格請求書(インボイス)登録番号の検証**、税率別の区分集計、和暦↔西暦変換、請求書データ生成を、AI との会話の中でそのまま実行できます。外部 API・ログイン不要、すべてローカルで完結します。

## ツール（8種・すべて動作検証済み）
| ツール | 内容 |
|---|---|
| `calc_consumption_tax` | 消費税計算（税抜↔税込・標準10%/軽減8%） |
| `calc_withholding_tax` | 報酬の源泉徴収税（10.21%／100万超は20.42%） |
| `validate_invoice_number` | 適格請求書番号(T+13桁)の形式＋**チェックディジット検証** |
| `summarize_by_tax_rate` | 明細を税率ごと(10%/8%)に**区分集計**（適格請求書の必須要件） |
| `check_qualified_invoice` | 適格請求書の**必須7項目**が揃っているか点検 |
| `wareki_to_seireki` | 和暦→西暦（令和/平成/昭和/大正/明治） |
| `seireki_to_wareki` | 西暦→和暦（改元境界も正確に判定） |
| `generate_invoice_data` | 明細から小計・消費税・合計＋必須項目を生成 |

## 導入（3通り）
**A. すぐ動かす（開発・単体利用）**
```
pip install mcp
python3 server.py
```
**B. コマンドとしてインストール（配布）**
```
pip install ./  又は  uvx --from . jp-invoice-tax-mcp
```
→ `jp-invoice-tax-mcp` コマンドが使えるようになります。

## Claude Desktop 設定
`claude_desktop_config.json`：
```json
{
  "mcpServers": {
    "jp-invoice-tax": {
      "command": "python3",
      "args": ["/絶対パス/products/mcp-jp-invoice/server.py"]
    }
  }
}
```
（インストール版なら `"command": "jp-invoice-tax-mcp", "args": []`）
再起動すると、会話の中で「この報酬の源泉いくら？」「このインボイス番号あってる？」等がそのまま使えます。

## 使用例（AIへの指示）
- 「税抜4,000円の消費税と税込額は？」→ 税抜4,000 / 消費税400 / 税込4,400
- 「報酬12万円の源泉徴収は？」→ 12,252円
- 「T1234567890123 は正しいインボイス番号？」→ チェックディジット検証で判定
- 「令和8年7月7日は西暦何年？」/「2026/7/7を和暦で」
- 「10%と軽減8%が混在する明細を税率別に集計して」

## 配布ロードマップ
- [x] 8ツール実装・全検証パス
- [x] wheelパッケージ化（`jp-invoice-tax-mcp` コマンド・隔離env install実証済）
- [ ] PyPI / mcp.so / GitHub 公開（★公開はユーザー承認後）
- [ ] freee/弥生 連携の第2号、見積書PDF等を追加

## 端数処理・精度について
- 消費税の端数は**切り捨て**を既定とし、浮動小数の誤差を避けるため**整数演算**で計算します（消費税法上、端数処理は事業者が選択できます）。
- `validate_invoice_number` は**形式とチェックディジットのみ**を検証します。国税庁への**実在登録の確認は行いません**（国税庁「適格請求書発行事業者公表サイト」で別途ご確認ください）。

## ライセンス / 免責
MIT License。個人・商用利用可。
**本ツールは一般的なルールに基づく補助ツールであり、税務・会計上の助言ではありません。** 計算結果の正確性・完全性を保証するものではなく、利用によって生じたいかなる損害についても作者は責任を負いません。**最終的な税務判断は必ず税理士・税務署にご確認ください。**

---
made by **panda studio** ・ 日本の実務に効くMCPを順次追加予定
