Kr Law

@pipeworx/kr-law

韓国の国家法令：タイトルで検索し、施行日が個別に定められた条文を1つずつ取得し、法令の改正履歴を確認できます。独自の OC（Open API ユーザー ID）をご用意ください。すべての呼び出しは、ご自身の登録情報で実行されます。

Pipeworx の一部です。AI エージェントを1815以上の稼働中のデータソースに接続する MCP ゲートウェイです。これは独立した非公式の連携であり、上流プロバイダーとの提携、承認、公開はありません。

ツール

• kr_law_search(...) — タイトルのキーワードで法令を検索します。各検索結果について、他のすべてのツールで必要となる mst（バージョン ID）、所管省庁、公布日・施行日、現行版か改正前の版かを返します。
• kr_law_article(...) — mst と article_no（例：제4조의2 の場合は "5" または "4-2"）を指定して、条文を1つだけ取得します。法令全体は取得しません。代わりに、ページ分割された目次（条番号とタイトル）を取得するには article_no を省略します。条文本文、その項（항）と号（호）、および条文独自の施行日を返します。条文だけが後から改正された場合、法令全体の施行日と異なることがあります。
• kr_law_history(...) — 法令の改正履歴を取得します。公布日・公布番号と施行日をそれぞれ持つ、すべての公布情報を返します。各履歴には個別の mst があり、kr_law_article に渡して使用できます。

認証

BYO のみであり、今後もこの方針です。すべてのツールで _apiKey が必要です。https://open.law.go.kr/LSO/main.do からご自身の OC を取得してください（ログイン → OPEN API → OPEN API 신청）。キーがない場合、ネットワーク呼び出しの前にすべてのツールが処理を拒否し、必要な引数と登録先を示します。

OC の登録には韓国での実名確認が必要です。韓国の携帯電話事業者による本人確認、または i-PIN が必要です。法務部の登録フォームには、外国人登録証、パスポート、海外からの登録に対応する方法はありません。Pipeworx には韓国在住のスタッフがおらず、どちらの方法も完了できないため、このパックで利用できるプラットフォームキーはなく、今後も提供予定はありません（決定記録、fleet #3128、2026-10-15）。

簡単な動作確認に限り（実際の認証情報として使用せず、安定して利用できるとも想定しないでください）、法務部の公開デモ ID "test" を kr_law_search と kr_law_article で使用できます。

kr_law_history には、OC で既定では有効になっていない場合があるサービスが必要です。 認証済みの実 OC でも、open.law.go.kr のダッシュボードにある My Applications で 법령연혁（法令履歴）を個別に有効にする必要があります（OPEN API → 신청내역 → 법령종류 のチェックボックスをオン）。この機能が有効でない OC を使うと、このツールは汎用エラーではなく、該当するサービス名を含むエラーを返します。エラーに示された手順に従ってください。公開デモ ID には、この利用資格がありません。

データソース

• 法務部（법제처）、国家法令情報センターの Open API — 韓国の公式法令データベースです（法律、大統領令、省令の本文、公布日・施行日、改正履歴を提供します）。

既知の制約と注意点

• 韓国語のテキストのみです。 翻訳は行っておらず、公式なものとも表示していません。韓国法制処は、この API を通じて公式の英訳法令テキストを公開していません。
• kr_law_history の成功時のレスポンス形式は、実際の呼び出しで検証されていません — このパックの構築中、履歴サービスを利用できる OC がありませんでした。エラーパス（その利用権限のない OC）は実際に検証済みで、プレミアム登録または完全登録をしていない多くの呼び出し元が実際に受け取るレスポンスです。ドキュメントに記載された行の形式から変わった場合は、お知らせください。
• article_no の枝番号：韓国の法令では、既存の条文番号をすべて振り直すのではなく、「제4조의2」のように既存の条文の間に新しい条文を挿入します。この場合は "4-2" として渡してください。article_no を指定せずに kr_law_article を呼び出すと、指定した mst で有効な値がすべて一覧表示されます。
• 法令自体の 시행일자（施行日）と、特定の条文の 조문시행일자（条文施行日）は異なる場合があります — 改正によって、1つの条文だけ施行日が先送りされることがあります。どちらも返され、別々に保持されます。
• www.law.go.kr はそれ自体が Cloudflare の背後にあり、正当なリクエストに対して HTTP 522/524/503 を断続的に返します（2026-10-15 の実測値：実際の呼び出し20回中1回）。すべてのツールは、最大3回までバックオフ付きで再試行してから終了します。それでもオリジンサーバーがダウンしている場合は、エラーに韓国の法令サービスから応答がなかったことと、再試行するよう明記されます。Cloudflare のステータスコードだけ、または「error code: 5xx」という本文がそのまま表示されることはありません。

クイックスタート

MCP クライアント（Claude Desktop、Cursor、Windsurf など）に追加します：

{
  "mcpServers": {
    "kr-law": {
      "url": "https://gateway.pipeworx.io/kr-law/mcp"
    }
  }
}

このエンドポイントが実際に提供するもの

https://gateway.pipeworx.io/kr-law/mcp の tools/list は、上記の表にあるツールに加えて、共通の Pipeworx メタツール — ask_pipeworx、discover_tools、search_within、remember/recall など、ゲートウェイ全体で共通のツールセット — も返します。そのため、表示されるツール数はこの表より多くなります。現在、単一パックのエンドポイントでは、そのパック独自のツールとともに共通ツールが約30個一覧表示されます。接続の initialize レスポンスには正確な対象範囲が記載されており、その日の時点での確定情報となります。

これは意図的なものであり、偶然の多重化ではありません。メタツールを使うと、パックの対象外の質問にも、カタログ全体を横断してルーティングする ask_pipeworx を介して回答できます。2つ目の MCP サーバーを追加する必要はありません。現在、メタツールなしでパックのエンドポイントを接続する方法はありません。追加のスキーマによるコンテキスト消費がルーティングの利点を上回る場合は、複数のパックエンドポイントではなく、フルゲートウェイに一度だけ接続してください。

また、フル Pipeworx ゲートウェイに接続すると、このパックだけでなく、すべてのパックのツールが直接一覧表示されます：

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

どちらの URL も同じゲートウェイと同じ1,815以上のデータソースに接続します。唯一の違いは、どのパックのツールが直接一覧表示されるかです。どちらからも ask_pipeworx を使ってすべてのツールにアクセスできます。

MCP クライアントがない場合：HTTP で呼び出す

このパックでは、ご自身の API キー（_apiKey）が必要です。こちらでキーを用意していないため、キーなしで実行できる curl コマンドはありません。任意のツールを確認するには、GET https://gateway.pipeworx.io/v1/tools/kr_law_search を使います。ツールを検索するには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を使います。

スタンドアロン（ゲートウェイアカウント不要）

このパッケージはローカルの stdio MCP サーバーとしても実行できます。Pipeworx アカウントもゲートウェイへの往復通信も不要です：

{
  "mcpServers": {
    "kr-law": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-kr-law"]
    }
  }
}

または、直接実行して起動を確認します：

npx -y @pipeworx/mcp-kr-law

stdin/stdout 経由で MCP を使用し、このパックのツールのみを対象に initialize/tools/list/tools/call に応答します。上記のゲートウェイ接続で追加される共通メタツールは含まれません。同じソース、同じツールで、ask_pipeworx によるルーティングはありません。

ask_pipeworx を使う

ツールを直接呼び出す代わりに、自然な英語で質問できます。これは上記のパックエンドポイントでもフルゲートウェイでも利用できます：

ask_pipeworx({ question: "your question about Kr Law data" })

ゲートウェイが適切なツールを選び、引数を自動的に設定します。

詳細

• ドキュメントとガイド
• pipeworx.io

ライセンス

MIT