Houki Egov MCP server

[!CAUTION]

旧リポジトリ名 houki-hub-mcp / 旧 npm 名 @shuji-bonji/houki-hub-mcp は使っていません。

現行は @shuji-bonji/houki-egov-mcp です。

Houki e-Gov MCP Server

日本の法令（憲法・法律・政令・省令・規則）を e-Gov 法令API v2 から、条・項・号の単位で、法令番号と URL を添えて返す MCP サーバ。

LLM が条文をキーワード・略称・分野で検索したり、特定の条項を Markdown / JSON で取得したり、改正履歴を引いたりできるようにする。通達・Q&A は @shuji-bonji/houki-nta-mcp が担当し、「法律で決まっている」と「通達でそうなっている」を混ぜない。

まず試す（ローカル DB なし）

登録するだけで、9 ツールのうち 8 つはそのまま動きます。e-Gov 法令 API v2 をその場で呼ぶためで、事前の取り込みは要りません。

// claude_desktop_config.json
{
  "mcpServers": {
    "houki-egov": {
      "command": "npx",
      "args": ["-y", "@shuji-bonji/houki-egov-mcp"]
    }
  }
}

再起動して「消費税法第 30 条第 1 項を見せて」「インボイス制度の登録要件は」のように尋ねると、searchlaw → getlaw の順に呼ばれ、法令番号と e-Gov の URL 付きで本文が返ります。

ローカル DB が要るのは searchfulltext（条文本文の横断検索）だけです。DB が無いときは searchlaw（法令名の検索）に切り替わり、応答の source が "api-fallback" になります。本文の全文検索が要ると分かったら、そのとき一度だけ下記の「CLI（ローカル DB の構築）」を実行してください。全法令 zip（約 290 MB）の取得と取り込みが走ります。

提供ツール

searchfulltext は、2 文字の語（「相殺」「時効」）を渡されたときに何をして結果を出したかを shorttokens で返します（v0.12.0）。索引が trigram で 3 文字以上の語しか載せないため、既定では条の本文を引かず、法令名を添える形と scanbody: true で走査する形を nextactions で示します。詳しくは2 文字の語の検索をご覧ください。

gettoc は、本則を toc、附則を改正法ごとに supplprovisions へ分けて返します（v0.13.0）。既定では附則は見出しと条数だけで、suppl: "full" で附則の中の条まで返します。詳しくは本則と附則の分け方をご覧ください。

listattachments / getattachment / getlawfile は、条文の文字列に入らないもの（別表・様式の図、Word や HTML の本文ファイル）を取る道です（v0.15.0）。ファイルの中身は応答に入れず、認証なしで開ける URL と、save: true のときだけ保存先の絶対パスを返します。詳しくは添付ファイルと法令本文ファイルをご覧ください。

getlawrange は、getlaw（1 条ずつ）と gettoc（目次だけ）の間を埋めます（v0.14.0）。民法の「第三編第二章 契約」のように章・節を指定すると、その中の条を本文ごと返し、長い範囲は条の単位で打ち切って続きの条番号を返します。詳しくは章・節単位の取得をご覧ください。

略称辞書（174 エントリ・6 分野）は @shuji-bonji/houki-abbreviations を内部で利用しています。

Shortened. The full README is on GitHub.