Skip to content
Back to search

tax-law-mcp

MCP server for Japanese tax law — e-Gov API & NTA 通達 (administrative circulars)

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/kentaroajisaka--tax-law-mcp/badge.svg)](/listings/kentaroajisaka--tax-law-mcp)

HTML

<a href="/listings/kentaroajisaka--tax-law-mcp"><img src="/api/listings/kentaroajisaka--tax-law-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 262 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # tax-law-mcp
  2. 日本の税法・通達・裁決事例を取得する MCP サーバー。
  3. Claude が税務の質問に回答する際、**条文や通達のハルシネーションを防止**するために、e-Gov法令APIおよび国税庁サイトから原文を取得して裏取りさせます。
  4. ## 特徴
  5. - **法令取得** — e-Gov法令API v2 から条文をMarkdown形式で取得
  6. - **法令検索** — キーワードで法令を横断検索
  7. - **通達取得** — 国税庁サイトから基本通達・措置法通達をスクレイピング(17通達対応)
  8. - **通達目次** — 通達の章・節構造を一覧表示
  9. - **裁決事例** — 国税不服審判所(kfs.go.jp)の公表裁決事例1,950件を検索・取得
  10. - **Shift_JIS対応** — 国税庁・国税不服審判所サイトの文字エンコーディングに対応
  11. - **主要税法プリセット** — 所得税法・法人税法・消費税法・措置法等のlaw_idをハードコード
  12. - **略称対応** — 「所法」「措法」「所基通」「措通(譲渡)」等の略称で指定可能
  13. ## MCP ツール
  14. | ツール | 説明 |
  15. |---|---|
  16. | `get_law` | e-Gov法令APIから条文を取得。法令名 + 条番号で指定。項・号・号の下のイロハ、附則にも対応。law_id 直接指定も可(例: `405AC0000000088`)|
  17. | `search_law` | キーワードで法令を検索 |
  18. | `get_tsutatsu` | 国税庁サイトから通達を取得。通達名 + 通達番号で指定 |
  19. | `list_tsutatsu` | 通達の目次を表示 |
  20. | `list_saiketsu` | 裁決事例の税目・カテゴリ一覧を表示 |
  21. | `search_saiketsu` | キーワードで裁決事例を検索(1,950件から) |
  22. | `get_saiketsu` | 裁決事例の全文を取得 |
  23. ## 対応法令(プリセット)
  24. 所得税法、法人税法、消費税法、相続税法、租税特別措置法、国税通則法、国税徴収法、各施行令・施行規則、民法、保険法 等(26法令)
  25. ## 対応通達(17通達)
  26. ### 基本通達
  27. | 通達名 | 略称 |
  28. |--------|------|
  29. | 所得税基本通達 | 所基通 |
  30. | 法人税基本通達 | 法基通 |
  31. | 消費税法基本通達 | 消基通 |
  32. | 相続税法基本通達 | 相基通 |
  33. | 財産評価基本通達 | 評基通 |
  34. | 連結納税基本通達 | — |
  35. | 国税通則法基本通達 | 通法基通 |
  36. | 印紙税法基本通達 | 印基通 |
  37. | 税理士法基本通達 | 税理士通達 |
  38. | 国税徴収法基本通達 | 徴基通 |
  39. | 酒税法基本通達 | 酒基通 |
  40. ### 措置法通達
  41. | 通達名 | 略称 |
  42. |--------|------|
  43. | 措置法通達(山林所得・譲渡所得関係) | 措通(譲渡) |
  44. | 措置法通達(申告所得税関係) | 措通(申告) |
  45. | 措置法通達(法人税編) | 措通(法人税) |
  46. | 措置法通達(相続税関係) | 措通(相続税) |
  47. | 措置法通達(源泉所得税関係) | 措通(源泉) |
  48. | 措置法通達(株式等譲渡所得等関係) | 措通(株式) |
  49. ## セットアップ
  50. ### npx(推奨)
  51. インストール不要。以下の設定をコピペするだけ:
  52. ```json
  53. {
  54. "mcpServers": {
  55. "tax-law": {
  56. "command": "npx",
  57. "args": ["-y", "tax-law-mcp"]
  58. }
  59. }
  60. }
  61. ```
  62. **Claude Desktop**: `~/Library/Application Support/Claude/claude_desktop_config.json` に追加
  63. **Claude Code**: `claude mcp add tax-law -- npx -y tax-law-mcp`
  64. ### ローカル(ソースから)
  65. ```bash
  66. git clone https://github.com/kentaroajisaka/tax-law-mcp.git
  67. cd tax-law-mcp
  68. npm install
  69. npm run build
  70. ```
  71. ```json
  72. {
  73. "mcpServers": {
  74. "tax-law": {
  75. "command": "node",
  76. "args": ["/path/to/tax-law-mcp/dist/index.js"]
  77. }
  78. }
  79. }
  80. ```
  81. ### リモート(Vercel)
  82. > ⚠️ **注意**: 現在、Claude のリモートMCP接続(カスタムコネクト)に既知の不具合があり、正常に動作しない場合があります。安定してご利用いただくには、npx(ローカル)でのセットアップを推奨します。
  83. 自前のVercelにデプロイすれば、チームメンバーはインストール不要で利用できます:
  84. ```bash
  85. vercel deploy
  86. ```
  87. ```json
  88. {
  89. "mcpServers": {
  90. "tax-law": {
  91. "url": "https://<your-deployment>.vercel.app/mcp"
  92. }
  93. }
  94. }
  95. ```
  96. ## REST API(v0.4.0〜)
  97. MCP に加えて、REST API エンドポイントも提供しています。Custom GPT (ChatGPT) の Actions や、Gemini、その他のAIツールから利用できます。
  98. ### エンドポイント一覧
  99. | エンドポイント | 説明 |
  100. |---|---|
  101. | `GET /api/get-law` | 条文取得(`law_name`, `article` 必須) |
  102. | `GET /api/search-law` | 法令検索(`keyword` 必須) |
  103. | `GET /api/get-tsutatsu` | 通達取得(`tsutatsu_name`, `number` 必須) |
  104. | `GET /api/list-tsutatsu` | 通達目次(`tsutatsu_name` 必須) |
  105. | `GET /api/list-saiketsu` | 裁決税目一覧(パラメータなし or `tax_type`) |
  106. | `GET /api/search-saiketsu` | 裁決検索(`keyword` 必須) |
  107. | `GET /api/get-saiketsu` | 裁決全文(`url` or `collection_no`+`case_no`) |
  108. ### 使用例
  109. ```bash
  110. # 所得税法第33条を取得
  111. curl "https://<your-domain>/api/get-law?law_name=所得税法&article=33"
  112. # キーワードで法令検索
  113. curl "https://<your-domain>/api/search-law?keyword=インボイス"
  114. # 通達を取得
  115. curl "https://<your-domain>/api/get-tsutatsu?tsutatsu_name=所基通&number=33-6"
  116. ```
  117. ### Custom GPT での利用
  118. 1. Vercel にデプロイ(`vercel deploy`)
  119. 2. `openapi.yaml` の `servers.url` をデプロイ先URLに書き換え
  120. 3. Custom GPT の「Actions」→「Schema」に `openapi.yaml` の内容を貼り付け
  121. 4. GPT に「所得税法33条を教えて」と聞くと、API で条文を取得して根拠付きで回答
  122. ### OpenAPI 仕様書
  123. `openapi.yaml` に OpenAPI 3.1 仕様書が含まれています。Custom GPT の Actions や Swagger UI でそのまま使えます。
  124. ## 使い方の例(MCP)
  125. ### 条文の取得
  126. > 「所得税法第33条を取得して」
  127. → `get_law(law_name="所得税法", article="33")`
  128. ### 号・イロハまで絞って取得
  129. > 「相続税法12条1項6号のイを取得して」
  130. → `get_law(law_name="相続税法", article="12", item=6, subitem="イ")`
  131. `paragraph` を省いても全項から号を探します。号番号は項をまたいで重複することがあるため、
  132. 実際にどの項に一致したかを見出しに表示します。枝番号の号は `item="12の5の2"` のように
  133. 文字列で指定してください。
  134. ### 附則の取得
  135. > 「保険法の附則の一覧を見せて」
  136. → `get_law(law_name="保険法", format="suppl")`
  137. > 「保険法の施行期日は?」
  138. → `get_law(law_name="保険法", supplementary=true, article="1")`
  139. 改正法の附則は法令番号で指定します。漢数字・算用数字のどちらの表記でも構いません。
  140. → `get_law(law_name="保険法", supplementary="平成29年法律第45号")`
  141. ### 通達の取得
  142. > 「所得税基本通達33-6を取得して」
  143. → `get_tsutatsu(tsutatsu_name="所基通", number="33-6")`
  144. ### 措置法通達の取得
  145. > 「措置法通達(譲渡)の33-8を取得して」
  146. → `get_tsutatsu(tsutatsu_name="措通(譲渡)", number="33-8")`
  147. ### 裁決事例の検索
  148. > 「重加算税に関する裁決事例を探して」
  149. → `search_saiketsu(keyword="重加算税")`
  150. ### 裁決事例の全文取得
  151. > 「裁決事例集第139集の1番を読みたい」
  152. → `get_saiketsu(collection_no=139, case_no=1)`
  153. ### 税目別の裁決事例一覧
  154. > 「所得税関係の裁決事例のカテゴリを見せて」
  155. → `list_saiketsu(tax_type="所得税")`
  156. ### ハルシネーション防止ワークフロー
  157. 1. Claude が税務の質問に仮回答を作成
  158. 2. 引用した条文・通達を `get_law` / `get_tsutatsu` で取得
  159. 3. 実際の原文と仮回答を照合し、誤りがあれば修正
  160. 4. 2-3 を収束するまで繰り返す(最大4ラウンド)
  161. ## 裁決事例(v0.3.0〜)
  162. 国税不服審判所(kfs.go.jp)の公表裁決事例(97冊・1,950件)を検索・取得できます。
  163. ### 対応税目(13税目)
  164. 国税通則法関係、所得税法関係、法人税法関係、相続税法関係、消費税法関係、地価税法関係、登録免許税法関係、印紙税法関係、揮発油税法関係、自動車重量税法関係、国税徴収法関係、租税特別措置法関係、たばこ税法関係
  165. ### 検索の仕組み
  166. - 事例集目次ページ(97冊分)をスクレイピングし、要旨テキストからキーワード検索
  167. - 初回は全ページ取得(30-60秒)、以降はキャッシュ利用(TTL 1時間)
  168. - `latest` パラメータで検索範囲を最新N冊に絞ることも可能
  169. ## 出典
  170. - 法令: [e-Gov法令検索](https://laws.e-gov.go.jp/)(デジタル庁)
  171. - 通達: [国税庁ホームページ](https://www.nta.go.jp/)
  172. - 裁決事例: [国税不服審判所ホームページ](https://www.kfs.go.jp/)
  173. 通達の利用は[国税庁コンテンツの利用について](https://www.nta.go.jp/chuijiko/copy.htm)に基づきます。
  174. ## 参考
  175. - [takurot/egov-law-mcp](https://github.com/takurot/egov-law-mcp) — XML→Markdown変換、ツール設計を参考にしました
  176. - [e-Gov法令API v2](https://laws.e-gov.go.jp/api/2/swagger-ui) — API仕様
  177. ## ライセンス
  178. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.