プロトタイプ · プレビュー版:公式レジストリのすべてのサーバーを掲載し、30分ごとに同期しています。Google でログインするとレビューを書けます。プロトタイプ · 30分ごとに更新
PopNx MCPAIを使う人のためのMCPサーバー · やさしい言葉で解説

Korean Law MCP

作者:chrisryugjバージョン 4.15.24i★ 2,896iクラウドで動くリポジトリ ↗
レジストリ名io.github.chrisryugj/korean-law-mcp

インストール方法

What it does

Korean law: statutes, precedents, ordinances, treaties and citation verification (법제처 API).

  • Connects クラウドで動く
  • Account or key Works without a key · add apikey if you have one (often raises limits)
  • Category 法律・行政データ

この順位の理由

一覧は利用スコア(100 点満点)で並びます。内訳は次のとおり

人気42/80GitHub スターか週間ダウンロード数。大きい方を 60、小さい方を 20 で数えます
新しさ12/1230 日以内のリリースかコード更新で満点
応答中8/8前回の確認でクラウドのエンドポイントが応答
利用スコア62/100

品質: 基本チェック 5/5 項目に合格(表示のみ、並び順には不使用) · 勢い: 7 (「急上昇」タブでのみ使用)

インストール

使っているAIアプリを選んで、設定をコピーしてください。

ひとことで AI にインストールしてもらう

Korean Law MCP をインストールして。https://mcp.popnx.com/i/chrisryugj-korean-law-mcp.md に従い、コマンドを見せて、私が OK するまで実行しないで。

パソコンで作業できる AI(Claude Code や Cursor など)に貼り付けます。手順を読み、コマンドを見せて、あなたの OK を待ちます。キー不要・登録不要。 · AI が読む全文を見る

チェック 5/5 合格 · 質問内容は提供元のサーバー(mcp.gomdori.app)を通ります · ✓ コマンド確認済み 2026年11月13日

まず:どの AI を使っていますか?

使っているアプリを選ぶと、下に手順が表示されます。

Claude につなげます · 約 2 分

キー不要、インストール不要 · claude.ai かデスクトップアプリで一度設定すれば、チャットで使えます · 無料アカウントは 1 つまで · Team/Enterprise はオーナー(Owner)が追加

  1. Claude の Connectors ページを開く

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  2. 「Add」→「Custom」→「Web」を押し、この 2 つを入力

    ここからコピーして Claude の同じ名前の欄に貼り付け、Continue を押します

    Name · 名前Korean Law MCP
    Remote MCP server URL · アドレスhttps://mcp.gomdori.app/law

    Claude が検出したサインイン設定の画面で Continue を押す · Authentication は作者の説明どおり(Sign in now・Sign in when needed・No sign in)を選び Add を押します

  3. チャットで有効にする

    +ConnectorsKorean Law MCP

  4. 試してみる

    Korean Law MCP を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude が Korean Law MCP を使っていると言うか、回答に Korean Law MCP のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

ChatGPT との接続はプランしだい

フル MCP:Web 版 ChatGPT の Business・Enterprise・Edu · Pro:読み取り/取得の権限で接続、データを変えるツールは使えないことがあります · Plus:公式ドキュメントで未確認。プラグイン画面にカスタム MCP を追加する項目があれば試せます · Web のみ

  1. Web 版 ChatGPT で MCP の追加ページを開く

    Plugins+Add custom MCP server

    ChatGPTPlugins1+2https://…3Create4
  2. 名前とアドレスを入力

    名前を入れ、Connection にアドレスを貼り付け、注意事項にチェックして Create as a plugin を押します

    Name · 名前Korean Law MCP
    Connection · アドレスhttps://mcp.gomdori.app/law
  3. チャットで Korean Law MCP を選ぶ

    新しいチャットを開き、入力前にプラグインの一覧から Korean Law MCP を選びます

  4. 試してみる

    Korean Law MCP を使って、私に何ができるか教えて、1 つやってみせて

    ✓ ChatGPT が Korean Law MCP を使っていると言うか、回答に Korean Law MCP のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に OpenAI のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Claude Code につなげます · 約 2 分

キー不要、インストール不要

  1. ターミナルを開く

    Mac:Command+スペースで Terminal と入力 · Windows:PowerShell を開く

  2. このコマンドを貼り付けて Enter

    claude mcp add --transport http --scope user korean-law https://mcp.gomdori.app/law
  3. Claude Code で /mcp と入力

    Korean Law MCP が一覧にあり、接続済みと表示されれば OK です

  4. 試してみる

    Korean Law MCP を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude Code が Korean Law MCP を使っていると言うか、回答に Korean Law MCP のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Cursor につなげます · 約 2 分

キー不要、インストール不要

  1. このボタンで Cursor を開く

    Cursor で開く

    Cursor がインストールの確認をするので Install を押します

  2. Cursor の AI チャットを Agent モードで開く

  3. 試してみる

    Korean Law MCP を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Cursor が Korean Law MCP を使っていると言うか、回答に Korean Law MCP のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Cursor のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

VS Code につなげます · 約 2 分

キー不要、インストール不要

  1. このボタンで VS Code を開く

    VS Code で開く

    VS Code がインストールの確認をするので Install を押します

  2. VS Code の AI チャットを Agent モードで開く

  3. 試してみる

    Korean Law MCP を使って、私に何ができるか教えて、1 つやってみせて

    ✓ VS Code が Korean Law MCP を使っていると言うか、回答に Korean Law MCP のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に VS Code のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Windsurf、Zed、Gemini CLI など MCP を使える他のアプリは追加方法がそれぞれ違います。アプリ一覧で確認してください

MCP を使えるアプリをすべて見る →

Web 経由でつなぐアプリ用のアドレス

アドレスhttps://mcp.gomdori.app/law

JSON 設定は下の「開発者向け」にあります

つまずいたら?Korean Law MCP を使っている人に聞いてみましょう💬 ディスカッション →
開発者向け:ターミナルのコマンドと JSON 設定

Web 経由

Claude Code

claude mcp add --transport http --scope user korean-law https://mcp.gomdori.app/law

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "korean-law": {
      "url": "https://mcp.gomdori.app/law"
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "korean-law": {
      "type": "http",
      "url": "https://mcp.gomdori.app/law"
    }
  }
}

自分で入力する値

  • apikey 秘密 HTTP header
    Your own 법제처 Open API key (free at https://open.law.go.kr). Optional: without it the shared server key is used under a rate limit.

説明は英語の原文のままです。

この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。

ひと目でわかる

週あたりのダウンロードi
npm/PyPIにない
接続方法
クラウドで動く
トランスポート
streamable-http
最新バージョンi
4.15.24
レジストリ公開日i
2026年11月17日
コードの最終更新i
2026年11月17日
最終確認
2026年11月18日
作者
chrisryugj
ウェブサイト
github.com
レジストリでの状態
有効

使えるアプリ

このサーバーのつなぎ方と、各アプリの公式ドキュメントに基づきます。2026年11月10日に確認。

インターネット経由でつなげるアプリ

ClaudeChatGPTGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast

すべてのアプリと長所・短所 →

できること

ツールの名前と説明は、サーバーが2026年11月18日に返したそのままの内容です。書いたのは作者で、私たちではありません。プレーンテキストとして表示しています。

  • search_law

    Korean-law-mcp — [법령검색] 법령명·조례명·행정규칙명 키워드검색 → lawId, mst 획득. 지자체 조례·규칙(자치법규), 훈령·예규·고시(행정규칙)도 검색 — 0건 시 자치법규/행정규칙으로 자동 폴백(예: '광진구 복무조례', '외국환거래규정'). 약칭 자동변환. 제명변경·시행예정 개정 자동 병기. 폐지된 법령·행정규칙은 폐지 사실과 후속(통합) 규정을 자동 안내. 법령·조례·행정규칙 조회 전 식별자 확보용.

  • get_law_text

    Korean-law-mcp — [법령조회] 조문 전문 조회. mst/lawId 필수, jo로 특정 조문만 가능 — jo는 '제148조의2' 같은 자연어 조문 표기를 그대로 받는다(권장). 6자리 JO 코드를 직접 쓰려면 조번호 4자리 zero-pad + 의X 2자리: 제10조의2→001002, 제234조의2→023402(234002 아님). jo='부칙' 이면 부칙 원문(시행일·경과조치, 최근 공포부터). 과거 시점 본문은 efYd 에 그 날짜를 넣으면 그날 시행 중이던 버전으로 자동 보정한다(제

  • ordinance_radar

    Korean-law-mcp — [자치법규] 조례 정비 레이더 — 조례가 인용한 근거 상위법령(법률/시행령/시행규칙)을 본문에서 추출하고, 각 상위법의 현행 시행일과 조례 시행일을 대조해 '상위법이 조례 시행 이후 개정됨 → 정비 검토 대상'을 자동 플래그. 조례 담당 공무원의 상위법 개정 추적·조례 정비 판단용. ordinSeq(또는 id)나 ordinanceName 중 하나 지정.

  • get_annexes

    Korean-law-mcp — [별표] 별표/서식 조회. lawName+'별표N'으로 내용 추출. 금액/기준은 별표에 있는 경우 많음. date(기준일)를 주면 그날 시행 중이던 버전의 별표 — 건축허가·착공·처분 시점의 설치기준·과태료표 등 과거 기준이 필요할 때(제명이 바뀐 법령도 옛 버전까지, 별표 번호가 시점마다 달라 query로 별표명을 주는 편이 안전).

  • legal_research

    Korean-law-mcp — [⛓리서치] 다단계 법령 리서치 통합 — 여러 API를 병렬로 엮는 복합 질문 전용. task: full_research=도메인·법령명 불명확한 자연어 질문 폴백(기본값, 예 '음주운전 처벌 기준') | law_system=법률·시행령·시행규칙 3단+위임+별표(예 '관세법 체계') | action_basis=처분·허가의 법적 근거+해석례+판례+행심(예 '영업정지 근거') | dispute_prep=불복·소송 준비, 판례+심판례+도메인 결정례(예 '과세처분 불복') |

  • legal_analysis

    Korean-law-mcp — [정밀분석] 검증·분석·신구조문대비표 5종 통합. mode: verify_citations=텍스트 속 법령 조문·판례 인용('민법 제750조', '대법원 2013다61381' 등)이 실존하는지 법제처 DB 교차검증, LLM 환각 방지 — 판례는 실존불가/미확인 구분(text 필수) | cite_check=판례 생사 확인 — 사건번호로 후속 인용 역추적+변경·폐기 감지, 한국형 Citator(caseNumber 필수) | applicable_law=사건 시점에 시행되던

  • discover_tools

    Korean-law-mcp — [메타] 전문도구(조세심판·관세·헌재·행심·공정위·개인정보위·노동위·학칙·조약·영문법령·용어 등 80+개) 카테고리 검색. 도구 이름과 설명을 돌려준다

  • execute_tool

    Korean-law-mcp — [메타] 전문도구를 이름(tool_name)과 인자(params)로 실행

  • search_decisions

    Korean-law-mcp — [통합검색] 23개 도메인(판례·해석례·헌재·행심·조세심판·관세·국세청·고용노동부·행정안전부 해석·중앙부처 1차 해석·공정위·개인정보위·노동위·산재보험재심사·고용보험심사·권익위·소청심사·학칙·공사공단·공공기관·조약·영문법령) 통합 검색. domain으로 선택. 판례 본문까지 필요하면 domain='precedent', options.includeText=true, options.detailLimit=N. 판례 기본은 판례명 검색이라 법리·사실관계·유사판례 탐색은 op

  • get_decision_text

    Korean-law-mcp — [통합조회] 23개 도메인 전문 조회. domain+id. full=false(기본) 시 본문 계단식 축약

基本チェックi

誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月19日にチェック

  • ✓ 合格

    作者とリポジトリが一致

    レジストリ名は、リポジトリを所有するGitHubアカウント chrisryugj で確認済みです

  • ✓ 合格

    今もメンテナンスされている

    コードの最終更新:一昨日

  • ✓ 合格

    ライセンスがある

    MITを使用

  • ✓ 合格

    エンドポイントが応答する

    940ミリ秒で応答(HTTP 200)

  • – 対象外

    OAuthでサインイン

    サインイン不要

  • ✓ 合格

    ツールの説明に隠れた指示がない

    10件のツールの説明を読み、AIへの隠れた指示は見つかりませんでした

クラウドのアドレスは直近 4 回中 4 回応答 · 最新 940 ms · 確認日 2026年11月18日

確認していること → · JSON

作者の方へ:再確認の依頼・情報の誤りの報告
作者向け:README にバッジを付ける

作者の方は、このコードを README に貼れます。バッジはこのページにリンクします。

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/chrisryugj-korean-law-mcp.svg)](https://mcp.popnx.com/en/servers/chrisryugj-korean-law-mcp)

話し合い

質問、コツの共有、使えないことの報告ができます。「役に立った」の多い順です。

まだ投稿はありません。最初の質問や共有をどうぞ。

ここの投稿は利用者によるもので、PopNx チームのものではありません。

ログインして投稿

ユーザーレビュー

まだレビューはありません

ログインしてレビューを書く

法律・行政データのほかのサーバーとの比較i

  • このカテゴリのほかの1945件のうち99%よりスターが多い
  • このカテゴリのほかの1945件のうち95%より最近レジストリに公開
  • 基本チェックの結果が、このカテゴリのほかの1945件のうち99%と同じかそれ以上

レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。

よくある質問

Korean Law MCPは安全ですか?

当てはまる基本チェック5項目のうち5項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。

どんなキーやコードが必要ですか?

レジストリには必須のキーは載っていません。ただし、最初に使うときにサインインを求めるサーバーもあります。

パソコンで動きますか、それともクラウドですか?

作者のクラウドで動きます。インストール不要でインターネット経由でつながりますが、送った内容は作者のサーバーを通ります。

今もメンテナンスされていますか?

GitHubリポジトリの最終更新は一昨日、最新バージョン(4.15.24)がレジストリに届いたのは一昨日です。

どのアプリで使えますか?

Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。URL で接続するので、リモート MCP を受け付けるアプリでも使えます。例:Web 版 ChatGPT(Business 以上はフル MCP、Pro は読み取りのみ)。

代わりに使えるものは?

同じカテゴリには:Global law, Open Legal Data (Germany), LibreJustice, InfraNode, Fedlex Connector

似た働きのほかの候補

同じカテゴリでほかの作者のもの。コマンドは確認済み。公式を先に、次にスター順。

カードの見方:↓ 週あたりのダウンロードi★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i

Global law

The law of nearly every country on earth, any date: read it, see what changed it, check citations.

作者:lexifina広く使われている★ 20969 日前更新

クラウドで動く✓ lexifina.com

LibreJustice

Search French-language and European case law and French legal texts (codes, statutes, treaties).

作者:librejustice初期★ 362 か月前更新

クラウドで動く✓ 提供元 · librejustice.fr

InfraNode

Keyless open data for 84 German cities: 12 lean read-only MCP tools covering 67 data types.

作者:street1983nk初期★ 185 か月前更新

クラウドで動く✓ 提供元 · infranode.dev
似たものと比べる
これ
Korean Law MCP
Global lawOpen Legal Data (Germany)LibreJusticeInfraNodeFedlex Connector
動く場所クラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要
キーが必要いいえいいえいいえいいえいいえいいえ
Claude で + から追加いいえいいえいいえいいえいいえいいえ
基本チェック5/54/44/44/44/44/4
ライセンスMITNOASSERTIONMITApache-2.0Apache-2.0MIT
料金登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし

作者のREADME

READMEを開く

作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。

Korean Law MCP

법제처 42개 API를 10개 도구로. 법령·판례·행정규칙·자치법규·조약·해석례(국세청 포함) 조회와 AI 답변의 인용 검증을 AI 어시스턴트나 터미널에서 바로 사용.

법제처 Open API 기반 MCP 서버 + CLI. Claude Desktop, Cursor, Windsurf, Zed, Claude.ai 등에서 바로 사용 가능.

English

바로 쓰기: Claude.ai 커넥터에 https://mcp.gomdori.app/law?oc=본인키 한 줄, Claude Code는 플러그인 두 줄 → 설치 및 사용법

VS Code·Cursor는 버튼 한 번으로 연결됩니다(키 없이 공용 한도로 동작, 본인 키는 주소 끝에 ?oc=본인키).

쓸모 있었다면 GitHub ⭐ 하나 눌러주세요. 다른 사람이 이 도구를 찾는 데 도움이 됩니다.

▶ 클릭하면 유튜브에서 재생됩니다.

AI에 연결하기
Claude에 연결하기ChatGPT에 연결하기

최근 업데이트

현재 버전 v4.15.23. 수치는 모두 CHANGELOG의 실측 기록에서 옮김.

버전주요 변경변화
4.15.23인용 검증: 항으로 나뉘지 않은 조문(민법 제750조 등)에 붙인 「제2항」을 ⚠ 대신 ✗로, 「제1항」은 조문 번호만 쓰라고 안내재현 테스트 5건
4.15.22행정안전부 법령해석 mois(지방세 유권해석) + 중앙부처 1차 해석 ministry(39개 부처, options.ministry) 도메인(#182). 지방세 해석 질의는 국세청 대신 행안부로 라우팅도메인 21 → 23
4.15.21대비표: 쉼표 붙은 후단 삭제 <후단 삭제> · 번호만 밀린 호·목 "(현행 제2호와 같음)" · 현행보다 긴 "(현행과 같음)" 범위는 현행 끝까지로(#181)재현 테스트 3건
4.15.20대비표 개정안 칸: 개정 부분이 마침표 바로 앞에서 끝나고 단서·후단이 신설되면 마침표가 「-」로 바뀌던 것(#180)건축법 제79조⑤ 재현 테스트
4.15.19대비표 한글(.hwpx) 본문 왼쪽 정렬 — 줄표가 넘어간 짧은 줄이 벌어지던 것한글 화면 확인
4.15.18legal_analysis 설명·제목에 「신구조문대비표」 낱말(claude.ai 도구 검색 0건 수정)검색 낱말 게이트 테스트
4.15.17대비표를 노출 도구 legal_analysis(mode="amendment_table")로(시연에서 숨은 도구를 안 찾음), 채팅 표 밑줄은 굵은 글씨노출 도구 10개 유지
4.15.16신·구조문대비표 작성 amendment_table(execute_tool): 개정 조문 → 현행 자동 대조, 밑줄·----·(생 략)·<신 설>, 로컬 실행은 한글(.hwpx) 저장처음 보는 100개 법령 433조문, 공식 대비표와 완전 일치 67.7%(구조 불일치 3.9%)
4.15.15별표 파서 kordoc 4.24.25(PDF 표 행·단위 표기 줄 수정 등), @hono/node-server 2.1.5npm audit 1건 → 0건, 실제 별표 3건 출력 동일
4.15.14보안: 의존성 취약점 정리 — 하위 kordoc 4.24.8(zod 4), zod 4.6.7, 개발 도구·하위 의존성 수정판npm audit 10건 → 0건
4.15.13Claude Code 플러그인이 로컬 npx 대신 공개 서버(mcp.gomdori.app/law)에 연결, 키는 선택설치 없음
4.15.12도구 사이 안내(예: 여러 법령 감시는 search_law_bulk)를 도구 설명에서 서버 안내문(instructions)으로 옮김같은 질문 4개에서 고르는 도구 동일
4.15.11노출 도구 10개에 사람용 제목(title·annotations.title) 추가: 클라이언트 승인 창에 "법령 검색"처럼 표시제목 0개 → 10개
4.15.10국세청 법령해석 본문 조회: 검색 결과의 본문조회ID(ntstDcmId)로 get_decision_text(domain="nts") — 요지·회신·본문 (#178)목록·링크만 → 본문까지

이전 버전 전체 내역은 CHANGELOG.md 참조. 대표 이정표:

  • v4.14.1: 조문 1개 조회 3.1초 → 0.24초(13배), 인용 15건 검증 ✓0 → ✓15
  • v4.13.0: 준법 등록부 감시 search_law 98회 호출 → search_law_bulk 1~2회
  • v4.4.0: 노출 도구 19개 → 9개, 도구 목록 컨텍스트 ~15.1KB → ~7.2KB (52% 감축)
  • v3.4.0: 판례·헌재·행심 응답 토큰 평균 74% 감축

왜 만들었나

대한민국에는 1,600개 이상의 현행 법률, 10,000개 이상의 행정규칙, 그리고 대법원·헌법재판소·조세심판원·관세청까지 이어지는 방대한 판례 체계가 있습니다. 이 모든 게 법제처라는 하나의 사이트에 있지만, 개발자 경험은 최악입니다.

이 프로젝트는 그 전체 법령 시스템을 10개 도구로 감싸서, AI 어시스턴트나 스크립트에서 바로 호출할 수 있게 만듭니다. 법제처를 수백 번 수동 검색하다 지친 공무원이 만들었습니다.


설치 및 사용법

공식 MCP 레지스트리 등재: io.github.chrisryugj/korean-law-mcp

0단계: API 키 발급 (무료, 1분)

법제처 Open API 인증키(OC)를 먼저 발급받으세요. 로컬 설치(방법 4·5)는 키가 꼭 있어야 하고, 공개 서버를 쓰는 방법(1~3)은 키 없이도 공용 한도로 동작합니다.

법제처 Open API 신청 페이지 접속 → 회원가입·로그인 → "Open API 사용 신청" → 신청서 작성 시 인증키(OC) 발급 (예: honggildong). 이 인증키를 아래 설정에서 사용.

방법 1: Claude Code 플러그인 (한 줄 설치, 가장 쉬움) ⚡

Claude Code를 쓴다면 두 줄이면 끝. API 키는 설치 중 자동으로 물어봅니다.

/plugin marketplace add chrisryugj/korean-law-mcp

/plugin install korean-law@korean-law-marketplace

설치 중 법제처 API 키를 묻습니다 (0단계에서 발급받은 honggildong 같은 키, 민감정보로 저장). 비워 두면 공용 한도로 동작합니다. 이후 Claude Code에 자연어로 질문하면("근로기준법 제74조 알려줘", "민법 제750조 판례 검증해줘") korean-law MCP 도구가 자동 호출됩니다. 새 버전은 한 줄로 최신화:

/plugin marketplace update korean-law-marketplace

플러그인은 공개 서버 https://mcp.gomdori.app/law 에 연결합니다(내 컴퓨터에 아무것도 설치하지 않음). 키는 apikey 헤더로 보냅니다. 서버를 거치지 않으려면 방법 4의 로컬 설치를 쓰세요.

Troubleshooting: Permission denied (publickey) 에러

설치 중 git@github.com: Permission denied (publickey).가 뜨면 설치기가 GitHub에 SSH로 접속했는데 SSH 키가 없는 경우 (처음 Git을 쓰는 비개발자·법률 실무자에게 자주 발생). 둘 중 하나로 해결:

  1. HTTPS로 강제 우회 (가장 간단, 추천): 아래 한 줄 실행 후 다시 /plugin install. 설치 후에도 그대로 둬도 무방 (HTTPS clone이 항상 동작)
   git config --global url."https://github.com/".insteadOf "git@github.com:"
  1. SSH 키 생성 후 등록: SSH를 자주 쓸 예정이라면
   ssh-keygen -t ed25519 -C "your-email@example.com"   # 엔터 3번

cat ~/.ssh/id_ed25519.pub # 출력 복사

   복사한 공개키를 [GitHub → Settings → SSH and GPG keys → New SSH key](https://github.com/settings/keys)에 붙여넣기
방법 2: Claude.ai 웹에서 바로 사용 (설치 없음)

아무것도 설치하지 않고 주소 하나만 입력. Claude Pro/Max/Team/Enterprise 요금제 필요 (Free는 커넥터 1개만 가능).

  1. claude.ai 로그인 → 왼쪽 사이드바 하단 본인 이름 → 설정(Settings) → 커넥터(Connectors)
  2. 커스텀 커넥터 추가 → 이름 korean-law(아무거나 OK), URL은 아래 주소 (honggildong을 0단계에서 발급받은 본인 인증키로 교체)
   https://mcp.gomdori.app/law?oc=honggildong
  1. 추가 → 커넥터 구성(Configure)에서 모든 도구를 항상 사용(Always allow)으로 설정 (매번 승인 불필요, 중요)
  2. 채팅에서 "근로기준법 제74조 알려줘" 입력

커넥터 URL을 수정하려면 삭제 후 다시 추가. 프로필 선택 불필요(10개 도구가 42개 API 전체 커버), 기존 ?profile=lite&oc=... 주소도 그대로 작동.

방법 3: AI 데스크톱 앱에서 사용 (설치 없음)

Claude Desktop, Cursor, Windsurf 같은 데스크톱 앱을 쓰고 있다면, 설정 파일에 아래 내용을 추가하세요.

설정 파일 위치 찾기:

앱 이름WindowsMac
Claude Desktop%APPDATA%\Claude\claude_desktop_config.json~/Library/Application Support/Claude/claude_desktop_config.json
Cursor프로젝트 폴더 안 .cursor/mcp.json프로젝트 폴더 안 .cursor/mcp.json
Windsurf프로젝트 폴더 안 .windsurf/mcp.json프로젝트 폴더 안 .windsurf/mcp.json
Claude Desktop

Claude Desktop은 원격 HTTP MCP 서버를 직접 연결하지 못하므로 mcp-remote 어댑터를 통해 연결합니다. Node.js 18 이상이 필요합니다 (npx 사용을 위해).

{

"mcpServers": { "korean-law": { "command": "npx", "args": [ "-y", "mcp-remote", "https://mcp.gomdori.app/law?oc=honggildong" ] } } }

honggildong을 본인 인증키로 바꾸세요. Node.js를 설치하기 싫다면 방법 4의 로컬 설치를 사용하세요.

Cursor, Windsurf 등 (원격 HTTP 지원 클라이언트)
{

"mcpServers": { "korean-law": { "url": "https://mcp.gomdori.app/law?oc=honggildong" } } }

이미 다른 MCP 서버가 설정되어 있다면, "mcpServers": { ... } 안에 "korean-law": { ... } 부분만 추가하면 됩니다.

저장 후 앱을 재시작하면 법령 도구가 활성화됩니다.

방법 4: 내 컴퓨터에 직접 설치 (오프라인 가능)

인터넷 없이 쓰고 싶거나, 원격 서버를 거치지 않으려면 직접 설치할 수 있습니다.

사전 준비: Node.js 20.19 이상이 설치되어 있어야 합니다 (22.12 이상 권장).

자동 설치 (추천):

npx --ignore-scripts --omit=optional korean-law-mcp setup

설치 마법사가 API 키 입력 → AI 클라이언트 선택 → 설정 파일 자동 등록까지 한 번에 처리합니다. Claude Desktop, Claude Code, Cursor, VS Code, Windsurf, Gemini CLI, Zed, Antigravity를 지원합니다. 현재 폴더에 쓰는 설정(Claude Code .mcp.json, VS Code .vscode/mcp.json)은 git에 커밋될 수 있어 키를 평문으로 넣지 않습니다. Claude Code는 ${LAW_OC} 참조를 넣으니 셸 설정에 export LAW_OC=발급받은키를 추가하고, VS Code는 처음 실행할 때 키를 묻습니다.

수동 설치:

npm install --ignore-scripts --omit=optional -g korean-law-mcp

AI 앱 설정 파일에 아래 내용을 추가합니다 (honggildong을 본인 인증키로 바꾸세요):

{

"mcpServers": { "korean-law": { "command": "korean-law-mcp", "env": { "LAW_OC": "honggildong" } } } }

앱을 재시작하면 완료!

방법 5: 터미널(CLI)에서 직접 사용

개발자라면 터미널에서 직접 법령을 검색할 수 있습니다.

# 설치

npm install --ignore-scripts --omit=optional -g korean-law-mcp

인증키 설정 (honggildong을 본인 키로 바꾸세요)

export LAW_OC=honggildong # Mac/Linux set LAW_OC=honggildong # Windows CMD $env:LAW_OC="honggildong" # Windows PowerShell

사용 예시

korean-law "민법 제1조" # 자연어로 바로 조회 korean-law search_law --query "관세법" # 도구 직접 호출 korean-law list # 전체 도구 목록 korean-law list --category 판례 # 카테고리별 필터 korean-law help search_law # 도구별 도움말

API 키 전달 방법 정리

여러 방법으로 인증키를 전달할 수 있습니다. 위에서부터 우선 적용됩니다:

방법사용법언제 쓰나
URL에 포함주소 끝에 ?oc=내키웹 클라이언트에서 가장 간편
HTTP 헤더apikey: 내키프로그래밍으로 연동할 때
환경변수LAW_OC=내키로컬 설치(방법 4, 5)
도구 파라미터apiKey: "내키"특정 요청만 다른 키 쓸 때

키 없이 공개 서버(mcp.gomdori.app/law)를 쓰면 무키 사용자 전원이 공유하는 서버 키 한도를 거침. 자체 키를 넘기면 이 한도와 무관함(무료 발급: https://open.law.go.kr).

법제처 API 프로토콜 설정

법제처 API 호출은 기본 HTTPS. 사내망·폐쇄망 등 인증서 검증이 어려운 환경에서는 LAW_API_PROTOCOL=http로 HTTP 호출 가능. 허용값은 http, https이며 설정하지 않거나 다른 값이면 https. MCP 클라이언트 설정의 env 블록에 넣는 방식이 가장 명확합니다:

{

"mcpServers": { "korean-law": { "command": "korean-law-mcp", "env": { "LAW_OC": "honggildong", "LAW_API_PROTOCOL": "http" } } } }

터미널 환경변수나 .env 파일(LAW_OC=honggildong 다음 줄에 LAW_API_PROTOCOL=http)도 가능:

export LAW_API_PROTOCOL=http        # Mac/Linux

set LAW_API_PROTOCOL=http # Windows CMD $env:LAW_API_PROTOCOL="http" # Windows PowerShell

국세청 판례 서버 TLS/프록시 설정

국세청 출처 판례 본문은 법제처 JSON 응답에 없을 때, 국세청 법령해석(nts) 본문은 항상 taxlaw.nts.go.kr을 조회합니다. 이 서버는 HTTP로 접근해도 HTTPS로 리다이렉트되므로, LAW_API_PROTOCOL=http와 별개로 Node.js 런타임이 https://taxlaw.nts.go.kr 인증서를 신뢰해야 합니다. 사내망·폐쇄망·SSL inspection 프록시 뒤에서는 브라우저로는 열려도 Node.js fetch()만 [EXTERNAL_API_ERROR] fetch failed로 실패할 수 있습니다(인증서 저장소·프록시 설정이 다름). 먼저 Node.js 기준으로 연결을 확인하세요:

node -e "fetch('https://taxlaw.nts.go.kr/qt/USEQTA002P.do?ntstDcmId=200000000000019303').then(r=>console.log(r.status,r.url)).catch(e=>console.error(e.name,e.message,e.cause))"

별도 웹 프록시를 거쳐야 한다면 프록시 주소를 설정합니다(국세청 판례 본문 fallback·국세청 법령해석 본문의 외부 HTTPS 연결에 적용). Windows 시스템 환경변수는 관리자 권한 터미널에서 setx로 등록하고, 적용 후 Windows 또는 Node.js 프로세스를 재시작하세요:

LAW_EXTERNAL_HTTPS_PROXY=http://proxy-host:8080
setx LAW_EXTERNAL_HTTPS_PROXY http://proxy-host:8080 /M

프록시 경로에서도 사내 인증서 검증 문제가 남으면, 원인 확인용으로만 이 프로젝트의 외부 HTTPS 프록시 경로에 한해 TLS 인증서 검증을 임시로 끌 수 있습니다. 운영 상시 설정으로 쓰지 마세요. 두 번째 줄은 진단 후 제거:

setx LAW_EXTERNAL_TLS_REJECT_UNAUTHORIZED 0 /M

reg delete "HKLM\SYSTEM\CurrentControlSet\Control\Session Manager\Environment" /v LAW_EXTERNAL_TLS_REJECT_UNAUTHORIZED /f


사용 예시

기본 조회
"관세법 제38조 알려줘"

→ search_law("

冒頭だけを表示しています。続きはリポジトリで読めます