Korea Data MCP

korea-data-mcp

英語 | 韓国語

韓国の公的 API をそのまま AI エージェントに渡すと、誤った回答が返ってきます。korea-data-mcp が正しい回答を返します。

OpenDART、data.go.kr、law.go.kr の公式無料 API を利用して、韓国企業の開示情報や財務情報、株価、マンションの売買価格、事業者登録状況、祝日、法令、裁判所の判決を提供する MCP サーバーです。

• 正確で、根拠も示します。 実際の API で見つかった47の落とし穴（上半期の売上高の誤り、まだ施行されていない法律、キャンセル済みの取引、2026年に変更された地区コードなど）に対処しており、それぞれ実際のレスポンスを使ったテストでカバーしています。全リストはこちらです：korea-data-mcp が対処すること。
• ワンクリックでインストールできます。 追加インストール不要の単一バイナリです。Claude Desktop では、korea-data-mcp.mcpb を開いてキーを入力してください。公式 MCP Registry にも登録されています。
• プライバシーを守ります。 お使いのマシン上で動作します。キーや質問は政府の API にのみ送信され、サードパーティーのサーバーを経由することはありません。また、テレメトリーもありません。
• 用途を絞っています。 説明が明確な15個のツールを備えているため、エージェントはコンテキストを多数のツールで埋めることなく、適切なツールを選べます。

重要な理由

例：「Samsung Electronics の2025年上半期の売上高はいくらでしたか？」OpenDART が実際に返す内容は次のとおりです。

{ "account_nm": "매출액", "thstrm_dt": "2025.01.01 ~ 2025.06.30",
  "thstrm_amount": "74,566,317,000,000", "thstrm_add_amount": "153,706,820,000,000" }

期間には1月から6月と記載されているため、エージェントは thstrm_amount を読み取り、₩74.6兆と回答します。これは誤りです。この値は第2四半期のみのものです。上半期の数値である₩153.7兆は、別のフィールドにあります。ほとんどの韓国 MCP サーバーは、このレスポンスをそのまま渡します。korea-data-mcp が返す内容は次のとおりです。

{ "name": "매출액", "statement_type": "income_statement",
  "current_period": "2025-01-01 ~ 2025-06-30",
  "current_amount": 153706820000000, "current_quarter_amount": 74566317000000 }

これにより、エージェントは正しく回答でき、第2四半期の内訳まで示せます。

誤った回答を気づかれないまま生み出す、ほかの落とし穴を3つ紹介します。

• まだ法律ではない法令。 law.go.kr に現行の労働基準法（근로기준법）を問い合わせると、2026-10-08から施行と記載された第44条の4が本文に含まれています。実際の施行日は2027-01-01です。公式の「現行法」本文には、まだ公布されたばかりの改正内容まで含まれています。korea-data-mcp は、指定した日付（デフォルトは今日）に施行されている本文を返し、今後施行される内容を upcoming に一覧表示します（ツールの出力は短縮しています）。

  

• 実際には成立しなかった取引。 マンションの売買データには、フラグで示されるのみのキャンセル済み取引が含まれています。2025年9月の江南区の233件の取引のうち12件が該当し、その中には₩75億の取引もあります。これらを含めた平均値は誤りです。korea-data-mcp は該当取引を除外します。

• いつの間にか使えなくなるコード。 2026年に、光州広域市と全羅南道が統合され、華城市は4つの区に分割され、仁川市では区が再編されました。ほとんどのコード表に残っている旧地区コードを使うと、過去の月も含めて取引件数が0件として返されます。korea-data-mcp なら、エージェントは 광주 북구 や 화성시 と指定するだけです。

ほかにも、HTTP 200 とともに返されるエラー、現行データに混在する古い記録、ハイフン付きで入力すると失敗する事業者番号、社名変更で分断された株価履歴、Go で失敗する TLS ハンドシェイクなどがあります。47項目すべてはこちらをご覧ください：korea-data-mcp が対処すること。

質問できること

korea-data-mcp を Claude（または任意の MCP クライアント）に接続して、英語または韓国語で質問できます。

• 「Samsung Electronics の 2025 年上半期の売上高はいくらで、最近どのような情報を開示しましたか？」
• 「2025 年 9 月の분당구のマンション販売価格の中央値はいくらでしたか？」
• 「労働基準法（근로기준법）の第44条の4は、すでに施行されていますか？」
• 「不当解雇（부당해고）に関する最近の最高裁判決を探し、最新の判決の判示内容を要約してください。」
• 「事業者登録番号 124-81-00998 は、現在も有効ですか？」
• 「先月、NAVER の株価はどのように推移しましたか？」
• 「今年、韓国の祝日はあと何日ありますか？」

ソース	対象	キー
OpenDART（電子公示）	約120,000社の企業プロフィール、開示情報、財務諸表	OPENDART_API_KEY
data.go.kr（公共データポータル）	祝日、法人情報、事業状況、マンション取引、株価	DATAGOKR_SERVICE_KEY
law.go.kr（国家法令情報）	任意の日付時点で施行中の法令、裁判所の判決	LAWGOKR_OC

3つのキーはすべて無料です。1つだけでも始められます。

クイックスタート

Claude Desktopならワンクリック： korea-data-mcp.mcpb をダウンロードして開く（または「設定」→「拡張機能」にドラッグする）だけで、所有しているキーを入力できます（キーの取得方法）。ほかにインストールするものはありません。手順4に進んでください。

1. インストール

macOS、Linux、Windows（Intel または ARM）用のバイナリをダウンロードします。リリースからダウンロードして展開し、korea-data-mcp（Windows では korea-data-mcp.exe）の絶対パスを控えてください。Apple Silicon 搭載 Mac の場合：

curl -L https://github.com/YoungsoonLee/korea-data-mcp/releases/latest/download/korea-data-mcp_darwin_arm64.tar.gz | tar xz
./korea-data-mcp -version

macOS では、ブラウザーでダウンロードしたバイナリは、開発元が未確認としてブロックされます。一度 xattr -d com.apple.quarantine korea-data-mcp を実行してください。curl でのダウンロードには影響しません。

または、Go を使用します。Go 1.26 以降が必要です（Go 1.21 以降では適切なツールチェーンが自動的にダウンロードされます）。

go install github.com/YoungsoonLee/korea-data-mcp/cmd/korea-data-mcp@latest

バイナリは $(go env GOPATH)/bin/korea-data-mcp にインストールされます。

2. キーを取得

まずは OpenDART から始めましょう。opendart.fss.or.kr で登録してキーを申請すると（인증키 신청）、すぐに発行されます。3つすべてのキーの取得手順を、韓国語のメニュー名とともに説明しています：APIキーの取得。キーは一部だけでも利用できます。キーがないプロバイダーのツールは表示されません。

韓国国外にお住まいですか？ これらのポータルへの登録には通常、韓国の本人確認（韓国の携帯電話番号）が必要なため、国外からキーを取得するのは難しい、または不可能な場合があります。自身のキーが不要なホスト版を提供する予定です：ウェイトリストに登録。

3. クライアントを接続

絶対パスを使用してください。所有していないキーは省略します。

Claude Code：

claude mcp add korea-data-mcp \
  -e OPENDART_API_KEY=... \
  -e DATAGOKR_SERVICE_KEY=... \
  -e LAWGOKR_OC=... \
  -- /absolute/path/to/korea-data-mcp

Claude Desktop： ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）または %APPDATA%\Claude\claude_desktop_config.json（Windows）を編集してから、Claude Desktop を再起動します。

{
  "mcpServers": {
    "korea-data-mcp": {
      "command": "/absolute/path/to/korea-data-mcp",
      "env": {
        "OPENDART_API_KEY": "...",
        "DATAGOKR_SERVICE_KEY": "...",
        "LAWGOKR_OC": "..."
      }
    }
  }
}

ほかの MCP クライアントでも、同じコマンドと環境変数を使用します。

キーを1つのファイルにまとめる場合は、.env.example を .env にコピーして値を入力し、引数として -env-file /absolute/path/to/.env を渡します。環境に設定された変数は、ファイル内の値より優先されます。

4. 動作を確認

エージェントに「有効になっている korea-data-mcp のプロバイダーはどれですか？」と尋ねます。エージェントは hub_list_providers を呼び出し、有効なプロバイダーと、不足しているキーを一覧表示します。その後、上記の質問を1つ試してください。

API キー

手順とトラブルシューティングについては、API キーの取得をご覧ください。3 つとも無料ですが、登録時に韓国の本人確認が必要となるのが一般的です。取得できない場合は、ホスト型サービスのウェイトリストに登録してください。

環境変数	取得元	取得方法
OPENDART_API_KEY	OpenDART	opendart.fss.or.kr → 認証キー申請（キーを申請）
DATAGOKR_SERVICE_KEY	data.go.kr	data.go.kr → 登録 → API ごとに申請（활용신청。リンクはツールを参照）→ My Page
LAWGOKR_OC	law.go.kr	open.law.go.kr → OPEN API 申請 → マイページ → API認証キー管理（OC）

data.go.kr：ポータルでは、Encoding と Decoding の 2 種類のキーが発行されます。Decoding keyを使用してください。Encoding key は URL エンコードが 2 回行われ、SERVICE_KEY_IS_NOT_REGISTERED_ERROR が発生します。申請するすべての API で 1 つのキーを使用できます。

law.go.kr：OC は、マイページ → API認証キー管理で自分で設定する値です。OC が間違っていると、「사용자 정보 검증에 실패하였습니다」というエラーが発生します。law.go.kr が返すすべてのリンクには OC が含まれているため、別のキーを OC として再利用しないでください（korea-data-mcp がそれらのリンクを渡すことはありません）。

ツール

OpenDART（OPENDART_API_KEY）

ツール	機能
opendart_search_companies	韓国語名／英語名、株式コード、または corp_code で企業を検索し、corp_code を取得します
opendart_get_company	企業プロフィール（기업개황）：CEO、市場、登録番号、住所、会計年度末
opendart_search_disclosures	企業、日付範囲、種類、市場で開示情報（공시）を検索します
opendart_get_financials	年度と報告書に対応する主要財務項目（주요계정）を、前期との比較とともに取得します

corp_code を受け取る OpenDART ツールはすべて、6 文字の株式コード（例：005930）も受け付けます。

data.go.kr（DATAGOKR_SERVICE_KEY）。各 API を利用するには、data.go.kr で個別に利用申請（활용신청）が必要です。リンクは以下のとおりです。

ツール	機能	申請する API
datagokr_list_holidays	年または月単位の祝日（공휴일）。振替休日、旧正月、秋夕、選挙日を含み、英語名と曜日も取得できます。また、記念日、二十四節気、季節の日も対象です。2004 年から 2 年先まで	한국천문연구원_특일 정보
datagokr_search_corporations	上場・非上場を問わず、韓国企業を名称で検索します。法人登録番号（crno）と、DART 提出企業の場合は opendart ツール用の dart_corp_code を返します	금융위원회_기업기본정보
datagokr_get_corporation	企業の最新プロフィール：CEO、市場、登録番号、設立日と上場日、住所、業種、従業員数、平均勤続年数と給与、監査人、監査意見	上記と同じ
datagokr_check_business_status	国税庁で最大 100 件の事業者登録番号（사업자등록번호）を確認します。登録の有無、営業中・休業中・廃業済みの状態（年月日を含む）、VAT 区分を取得できます。ハイフンも使用できます	국세청_사업자등록정보 진위확인 및 상태조회
datagokr_list_apartment_trades	地域と月を指定して、マンションの売買取引を新しい順に取得し、価格の中央値・最小値・最大値の概要を表示します。価格は KRW です。既定では取引取消分を除外します。マンション名または近隣地域で絞り込めます。地域には名称（강남구、서울 중구、분당구、광주 북구）または 5 桁のコードを指定できます。수원시 や 화성시 のように区を含む市を指定すると、市内のすべての区が対象になります	국토교통부_아파트 매매 실거래가 자료
datagokr_get_stock_prices	KOSPI、KOSDAQ、または KONEX 銘柄の日次価格：終値、変動額、始値／高値／安値、出来高、取引代金、時価総額。銘柄には名称（삼성전자、naver）、6 桁のコード、または ISIN を指定できます。名称変更があっても、コードに基づいて過去の履歴を追跡します。2020 年以降	금융위원회_주식시세정보

law.go.kr（LAWGOKR_OC）

ツール	機能
lawgokr_search_laws	施行中の法令（法律、政令、規則）を、名称または正式な略称（민법、중대재해처벌법）、あるいは in_text を使った条文の文言で検索します。一致度の高いものと法律が先に表示されます
lawgokr_get_law	指定日（既定では今日）に施行中の法令本文を、全体または条文（제50조、43의2）単位で取得します。項、号、目も含まれます。後日施行される公布済みの改正は upcoming に一覧表示されます。as_of には過去または未来の日付を指定できます
lawgokr_search_precedents	裁判所の判例（판례）を、新しい順に、事件名、全文、事件番号（2020다296604。空白も使用できます）、裁判所、判決日で検索します。既定では裁判記録のみを対象とするため、すべての結果を閲覧できます
lawgokr_get_precedent	ID または事件番号で判例を取得します。争点（판시사항）、判決要旨（판결요지）、引用された法令と判例、および include_full_text で全文を取得できます

ハブ：hub_list_providers は有効なプロバイダーと、不足しているキーを一覧表示します。

セキュリティ、制限、新鮮さ

• キーはお使いのマシンに保持されます。 korea-data-mcp はローカルで動作し、各キーを発行元のサービスにのみ送信します。テレメトリーはありません。エラーメッセージにキーやクエリー文字列が含まれることはありません。
• HTTP モードには認証がありません。 -http は、ポートにアクセスできるすべてのユーザーに、お使いのキーを使用してツールを提供します。認証プロキシの背後で動作させる場合を除き、localhost にバインドしてください（-http 127.0.0.1:8080）。デフォルトの stdio モードではポートを開きません。
• 上流サービスの利用枠が適用されます。 data.go.kr の開発者アカウントでは、各 API を1日あたり10,000回呼び出せます。OpenDART と law.go.kr にはそれぞれ独自の制限があります。korea-data-mcp はレスポンスを10分間、DART の企業一覧を24時間キャッシュします。
• データの鮮度はソースに依存します。 マンションの取引は契約から最大30日後に報告されるため、最新月のデータは時間の経過とともに充実します。株価は日次で、各取引日の終了後に更新されます。

ロードマップ

• OpenDART：企業、開示、財務情報
• data.go.kr：祝日、法人情報、事業者の営業状況、マンション取引、株価
• law.go.kr：法令、裁判所の判決
• 韓国銀行 ECOS、KOSIS（韓国統計情報サービス）
• 日本向けの姉妹サーバー（企業開示情報の EDINET から開始）

データソースの追加をご希望ですか？リクエストする。API の動作に問題を見つけましたか？issue を作成する。韓国の API キーをお持ちでない場合は、ホステッドサービスのウェイトリストに登録する。ビルド、テスト、プロバイダーの追加については、docs/DEVELOPMENT.mdをご覧ください。

ライセンス

Apache License 2.0。ツールが返すデータは上流サービスから取得したものであり、それぞれの利用規約が適用されます。