taxlaw-nts-mcp

国税法令情報システム(https://taxlaw.nts.go.kr)の資料をMCPツールで検索するSTDIOサーバーです。

法制処のサイトでは検索しにくい国税庁の税法解釈、質疑応答、租税不服文書、基本通達、別表/様式、刊行物、ホームタックス相談事例を補完的に検索します。

専用の高レベルツールがまだ存在しないメニューにもアクセスできるよう、確認済みのサイトメニュー/actionリスト照会、action.doの直接呼び出し、および同一サイトのHTMLテキスト取得ツールを併せて提供します。

English

korean-law-mcpとの併用方法

税法に関する質問は、まずkorean-law-mcpを使用して法令条文、施行令、判例、租税審判などの法制処/法令DB資料を確認し、法制処の検索で国税庁の質疑応答・基本通達・ホームタックス相談事例・刊行物が見つからない場合に、このサーバーで補完検索することをお勧めします。

両方のMCPが同じ判例・決定例・解釈例を見つけた場合は、文書番号/請求番号/事件番号から空白・ハイフンを除去した値、作成日/議決日、タイトルを基準に一つに整理してください。同じ項目を重複して並べず、両方のソースIDを併記し、国税法令情報システムにのみ存在する原文スニペット・ホームタックス相談・基本通達・刊行物は、このサーバーの結果で補完してください。

このサーバーは国税法令情報システムの応答に存在する項目のみを表示し、検索失敗や外部サイトのエラーが発生した場合は [NOT_FOUND]、[EXTERNAL_API_ERROR]、[INVALID_PARAMETER] などのマーカーと推測禁止の警告を返します。

Related MCP server: Korean Law ALIO MCP

提供ツール

全メニューへのアクセス

まず list_taxlaw_site_menus でメニューキー、URL、確認済みの actionId、デフォルトの paramData を確認します。専用ツールがあるメニューは該当する高レベルツールを使用し、ないメニューは call_taxlaw_action に actionId、defaultParamData、refererPath を渡して生の応答を照会します。税目別要約情報や税法改正建議のように静的HTMLで提供される資料は、get_taxlaw_page_text に /html/U_0101.html、/cm/USECMJ001M.do などのパスを渡して照会します。税務日程は list_taxlaw_site_menus(query="세무일정") で確認した ASECMC001MR01 action に year、month を渡して照会できます。

npm install
npm run build
npm start

MCPクライアントからローカルソースパスで実行するには：

{
  "mcpServers": {
    "taxlaw-nts": {
      "command": "node",
      "args": ["/absolute/path/to/taxlaw-nts-mcp/build/index.js"]
    }
  }
}

npmにデプロイした後は、グローバルインストール後により短く登録できます。

npm install -g taxlaw-nts-mcp

{
  "mcpServers": {
    "taxlaw-nts": {
      "command": "taxlaw-nts-mcp"
    }
  }
}

環境変数

APIキーは不要です。国税法令情報システムの呼び出しに使用するUser-Agentのみ、必要な場合に変更可能です。

TAXLAW_USER_AGENT="Mozilla/5.0 ..."

エラー応答の原則

検索または詳細照会の結果がない場合は [NOT_FOUND] と isError: true を返します。外部サイトのエラーは [EXTERNAL_API_ERROR]、不正な入力は [INVALID_PARAMETER] として返します。結果本文にはソースURLと実際に照会したIDを併記します。

開発

npm run build
npm run watch
npm pack --dry-run

ライセンス

MIT