korea-stock-insight-mcp

Korea Stock Insight MCP

mcp-name: io.github.yjhann33-design/korea-stock-insight-mcp

英語を第一に設計した MCP — 韓国語が堪能な話者ではなく、世界中の LLM アナリスト向けです。

Claude Desktop、Cursor、Cline、およびあらゆるMCP 対応クライアントにそのまま導入できます。英語で質問するだけで、韓国の開示情報、財務情報、KOSPI／KOSDAQ の株価を、DART corp_code の検索、開示情報、XBRL 財務諸表、日次 OHLCV まで、一連のツール呼び出しで取得できます。

利用できる機能

ツール	内容
get_today_date	KST／UTC の今日の日付（YYYYMMDD）— 日付範囲を指定するクエリの前に呼び出します
get_corp_code	韓国企業名または6桁のティッカーを DART corp_code に変換します
get_disclosure_list	DART の最近の開示情報（日付、タイトル、種類、受付番号）
get_disclosure	開示情報のメタデータと正規ビューアー URL
get_financial_statement	完全な XBRL 財務諸表（連結／個別、四半期／年次）
get_stock_quote	KOSPI／KOSDAQ の日次 OHLCV（yfinance 経由、キー不要）

DART（電子公示システム）は韓国の電子開示システムです。金融監督院（FSS）が運営しており、米国 SEC の EDGAR に相当します。

英語を第一に設計する理由

韓国の公開書類は韓国語で書かれており、ティッカーコードは世界共通の覚えやすい表記のない6桁の数字です。また、開示システム（DART）には EDGAR の全文検索に相当する英語機能がありません。韓国語を話さないアナリストにとって、実際の調査を始める前に3つの障壁があります。

このサーバーはそれらを取り除きます。ツールの説明、パラメーター名、使用例はすべて、韓国語を読まない LLM 向けに書かれています。企業名の検索には英語名（「Samsung Electronics」、「Naver」）を使え、回答には必要に応じて英語の補足情報が含まれます。ワークフローも、ブラウザーのタブを3つ開く代わりに、Claude／Cursor との1回のやり取りで完結します。

• 英語を第一にしたツールの説明 — 名前、パラメーター、使用例はすべて英語です
• DART と KRX を一か所に集約 — 開示情報、財務情報、日次株価を単一の MCP 経由で取得できます
• 1行でインストール、アカウント不要 — uvx korea-stock-insight-mcp を実行すれば完了です（無料の DART キーのみ必要です）
• ローカル stdio、MIT、テレメトリーなし — クエリがマシンの外に送信されることはありません

クイックスタート（Claude Desktop）

1. 無料の DART API キーを取得する

opendart.fss.or.krで登録し、ユーザーページから API キーを取得します。すぐに発行され、無料で、クレジットカードも不要です。

2. Claude Desktop の設定に追加する

claude_desktop_config.jsonを編集します（場所：macOS ~/Library/Application Support/Claude/、Windows %APPDATA%\Claude\）。

{
  "mcpServers": {
    "korea-stock-insight": {
      "command": "uvx",
      "args": ["korea-stock-insight-mcp"],
      "env": {
        "DART_API_KEY": "YOUR_DART_KEY_HERE"
      }
    }
  }
}

uvxがない場合は、まずuvをインストールします（macOS／Linux／Windows では1行でインストールできます）。または、pipxを使用します。

{
  "mcpServers": {
    "korea-stock-insight": {
      "command": "pipx",
      "args": ["run", "korea-stock-insight-mcp"],
      "env": {"DART_API_KEY": "YOUR_DART_KEY_HERE"}
    }
  }
}

3. Claude Desktop を再起動して試す

「Samsung Electronics の最新の開示情報は何ですか？ 前四半期の売上高と営業利益を取得してください。」

Claude は get_corp_code("Samsung Electronics") → get_disclosure_list("005930") → get_financial_statement(corp_code, 2025, "FY") を自動的に連鎖して実行します。

クエリ例（30秒、Claude にコピー＆ペースト）

世界中のアナリストが韓国株の分析で実際に行う3つのワークフローです。それぞれ2〜4回のツール呼び出しを自動的に連鎖します。

1. メモリーサイクルの同業他社比較

「Samsung Electronics と SK Hynix の最新の年次報告書について、売上高、営業利益率、設備投資を比較してください。両社の違いを強調してください。」

両社名を corp_code に変換し → 最新の XBRL を取得し → 並べて比較できる形式で返します。HBM／DRAM サイクルの追跡に便利です。

2. 重要イベント前の開示情報をチェック

「Naverの過去30日間のDART開示情報を表示してください。決算、M&A、自社株買い、役員の異動に関するものがあればフラグを立ててください。」

日付の範囲を指定してget_disclosure_listを実行し、Claudeがタイトルを確認して分類します。韓国語を読む必要はありません。どの種類の開示情報を探すべきかは、ツールの説明からClaudeが把握できます。

3. 株価と開示情報を一度に確認

「Kakaoが最後に提出した開示情報は何ですか？ また、過去90日間でKOSPIの株価はどのように動きましたか？」

get_disclosure_listとget_stock_quoteを組み合わせ、ニュースとそれに対する株価の反応を同じ回答で確認できます。

その他の例

• 「LG Energy Solutionの最新の年次報告書を取得して、経営陣による説明を要約してください。」
• 「KODEX 200 ETFの過去6か月のトレンドはどうですか？」（ETFにも対応しています）
• 「Hyundai Motorについて、2025年に主要事項報告書（주요사항보고서）としてタグ付けされた開示情報をすべて一覧表示してください。」

今後の予定

• v0.2 — 開示本文の完全な抽出（ZIP形式のXBRL → プレーンテキスト）
• v0.3 — 複数企業の一括クエリ、セクター別集計
• 今後 — 英語で要約した開示情報とWebhookによるプッシュ通知を備えたオプションのホステッドプラン（提供時期未定。GitHub Issuesで進捗をご確認ください）

フィードバックと貢献

このプロジェクトは個人でメンテナンスしており、stdioモードでは誰が利用しているかを確認できません。把握できるのは、PyPIのダウンロード数、GitHubのスター数、そして皆さんから寄せられる情報だけです。

お役に立てた場合は、ぜひお知らせください。

• 🐛 イシューを作成 — バグ、不足しているツール、動作しないクエリ
• 💬 ディスカッション — 「[ticker]を分析した人はいますか？」「Xにはこのツールが適していますか？」といった質問や、一般的な質問
• ⭐ リポジトリにスターを付ける — 需要を伝え、今後の予定を形作る最も簡単な方法です

ClaudeやCursorを使って韓国株を実際に分析している方がいれば、どのようなクエリを実行しているか、何が不足しているかをぜひお聞かせください。

ライセンス

MIT。LICENSEをご覧ください。

謝辞

• 韓国の金融監督院によるDART OpenAPI
• yfinance経由のKRX日次価格
• AnthropicによるModel Context Protocol