jjlabsio-korea-stock-mcp

Korea Stock MCP サーバー

🇰🇷 한국어 | 🇺🇸 English

🚀 Korea Stock MCPは、オープンソースMCPからさらに一歩先へ進みます。 正確な韓国株式データをもとに、AIがより信頼できる回答を提供できるよう支援する新しいサービスを準備しています。新しいサービスの方向性をご覧ください。

韓国株式の分析に利用できるMCP サーバーです。
DART（電子公示システム）とKRX（韓国取引所）の公式APIを通じて、株価情報や公示資料に基づくAI分析が可能です。

💬 改善要望とフィードバックをお待ちしています！ ご利用の際に不便な点や改善のアイデアがございましたら、お気軽にメールでお知らせください。 迅速に確認し、反映いたします。 📧 [email protected]

🎯 主な機能

• 🔍 公示検索 - 会社別、期間別の公示を検索
• 📊 公示データ - 公示報告書の原本ファイルを解析したデータを提供
• 💼 財務諸表分析 - XBRLに基づく詳細な財務データ
• 📈 株式データ - KRX（KOSPI／KOSDAQ）の日次株価情報、銘柄基本情報

⚡ クイックスタート

1️⃣ API KEYの取得

まず、DARTとKRXのAPI KEYを取得する必要があります。

📝 DART API KEYの取得

1. 会員登録：OPEN DARTで会員登録
2. キーの申請：認証キー申請ページでAPI KEYを申請
3. キーの確認：オープンAPI利用状況で発行されたAPI KEYを確認

📈 KRX API KEYの取得

1. 会員登録：KRX OPEN APIで会員登録してログイン

2. キーの申請：マイページ → API認証キー申請から申請

3. サービスの申請：承認後、「サービス利用」→「株式」メニューに移動

4. API利用申請：以下の6項目それぞれで「API利用申請」をクリック

   • 有価証券の日次売買情報
   • KOSDAQの日次売買情報
   • KONEXの日次売買情報
   • 有価証券の銘柄基本情報
   • KOSDAQの銘柄基本情報
   • KONEXの銘柄基本情報

   ⏱️ 承認まで約1日かかります。

5. キーの確認：承認後、マイページ → API認証キー発行履歴でAPI KEYを確認

2️⃣ Claude Desktopの設定

1. Claude Desktopを起動
2. 設定 → 開発者 → 設定を編集をクリック
3. claude_desktop_config.jsonファイルに以下の内容を追加：

{
  "mcpServers": {
    "korea-stock-mcp": {
      "command": "npx",
      "args": ["-y", "korea-stock-mcp@latest"],
      "env": {
        "DART_API_KEY": "<YOUR_DART_API_KEY>",
        "KRX_API_KEY": "<YOUR_KRX_API_KEY>"
      }
    }
  }
}

4. 再起動：Claude Desktopを再起動して設定を適用

これでClaudeで韓国株式データの分析を開始できます。

大容量の公示文書の処理

一部の公示報告書（事業報告書、四半期報告書など）は、数MBに達する大容量のXML文書です。 このような文書を一度にすべて処理すると、AIの応答上限を超えたり、エラーが発生したりすることがあります。

どのように動作しますか？

文書のサイズに応じて、処理方法が自動的に切り替わります。

• 小容量の文書（1MB未満）：文書全体をそのまま返します。
• 大容量の文書（1MB以上）：文書全体ではなく、まず**目次（TOC）**を返します。Claudeが目次を確認し、質問に関連するセクションを自動的に選んで内容を取得します。

ユーザー向けの案内

特別な操作は必要ありません。 Claudeが大容量の文書を自動的に処理します。

文書が大きい場合、Claudeは次のように自動で動作します：

1. 文書の目次を確認します。
2. 質問に関連するセクションを自動的に選んで、内容を取得します。
3. 回答後に残りのセクション一覧を案内するため、さらに知りたいセクションがあれば依頼できます。

例：

• 「事業報告書から売上の状況を教えて」→ Claudeが売上に関連するセクションを自動的に選択
• 「先ほどの目次の3番目のセクションも取得して」→ 特定のセクションを直接依頼可能

💡 複雑な質問は段階に分けて尋ねてください

一度に望む回答が得られない場合は、質問を複数の段階に分けると、より正確な結果を得られます。

たとえば、「インベンテラの証券届出書から外国人への割当内容を教えて」という質問で一度にうまくいかない場合：

1. 「インベンテラの固有番号（corp_code）を教えて」
2. 「その会社の証券発行に関する公示一覧を表示して」
3. 「該当する公示の本文を取得して」
4. 「外国人への割当内容を探して」

このように段階を追って進めると、各段階の結果を確認しながら、必要な情報にたどり着けます。

---

利用可能なツール

DART（電子公示システム）

1. get_disclosure_list - 公示検索

   • 公示の種類、会社、日付別に公示報告書を検索

2. get_corp_code - 固有番号の照会

   • DARTに登録された公示対象会社の固有番号、会社名、銘柄コードを提供
   • 会社名（corp_name）または銘柄コード（stock_code）のいずれかで照会可能
   • 会社名での検索に失敗した場合、銘柄コードで再試行するよう案内

3. get_disclosure - 公示報告書の原文

   • DART APIを通じて公示報告書の原本ファイルを解析
   • 大容量の文書の場合は目次を返し、section_idで特定のセクションを照会可能

4. get_financial_statement - 財務諸表

   • 上場法人および主要な非上場法人のXBRL財務諸表
   • 定期報告書に含まれるすべての勘定科目データを提供

KRX（韓国取引所）

1. get_stock_base_info - 銘柄基本情報

   • KOSPI、KOSDAQ、KONEX上場銘柄の基本情報
   • 銘柄名、銘柄コード、市場区分などの基本データ

2. get_stock_trade_info - 日次売買情報

   • KOSPI、KOSDAQ、KONEXの銘柄別の日次取引データ
   • 株価、取引量、時価総額などの詳細な取引情報

3. get_market_type - 市場区分の照会

   • 銘柄コードから該当銘柄の市場区分（KOSPI／KOSDAQ／KONEX）を照会
   • 株式データの照会に必要な市場情報を提供

その他のツール

1. get_today_date - 今日の日付の照会
   • 現在の日付をYYYYMMDD形式で提供
   • AIが正確な日付を取得するためのツール

実際の利用例

📊 財務分析の例

プロンプト：「三養食品の2023年、2024年の第1～第4四半期、2025年の第1・第2四半期の売上高と営業利益を調べ、成長率も調べて」
→ 三養食品の分析結果を見る

プロンプト：「APRの2023年第1四半期から2025年第2四半期までの売上高と営業利益の成長、株価、時価総額の推移を調べて」
→ APRの分析結果を見る

🏢 企業分析の例

プロンプト：「HJ重工業は何をして収益を得ている会社なのか、事業部門別の売上高もあわせて教えて」
→ HJ重工業の分析結果を見る

📑 公示分析の例

プロンプト：「IPO（例：Inventera／0007J0）の外国人への割当内容を教えて」 → インベンテラのIPO外国人割当分析結果を見る

API データソース

• DART（電子公示システム）：上場企業の公示情報および財務諸表
• KRX（韓国取引所）：銘柄の基本情報および日次取引情報

ローカル開発とテスト

ソースを修正しながら、すぐにテストする方法です。

1️⃣ 依存関係のインストール

npm install

2️⃣ 環境変数の設定

プロジェクトのルートに .env ファイルを作成します：

DART_API_KEY=your_dart_api_key
KRX_API_KEY=your_krx_api_key

3️⃣ MCP Inspector の実行

npm run inspect

ターミナルに表示されるアドレス（http://localhost:6274 など）をブラウザーで開くと、MCP Inspector の UI が開きます。

Inspector で Connect ボタンをクリックした後、左側のツール一覧から目的のツールを選択して、直接呼び出すことができます。

4️⃣ ソースの修正後に再テスト

src/ ファイルを修正して保存すると、サーバーが自動的に再起動します。 Inspector で Reconnect ボタンをクリックすると、変更がすぐに反映されます。

注記：Node.js 18 以上が必要です。

コントリビューション

コントリビューションを歓迎します！Pull Request をお送りください。

1. このリポジトリをフォークします
2. 機能ブランチを作成します（git checkout -b feature/AmazingFeature）
3. 変更をコミットします（git commit -m 'Add some AmazingFeature'）
4. ブランチにプッシュします（git push origin feature/AmazingFeature）
5. Pull Request を作成します

ライセンス

ISC ライセンス

サポート

• 🐛 問題がある場合は、GitHub Issues に登録してください
• ⭐ 役に立った場合は、スターを付けてください！

免責事項

本ツールは情報提供を目的としており、投資助言ではありません。すべての投資判断はご自身の責任で行ってください。

---

英語版

🚀 Korea Stock MCP は、オープンソース MCP の枠を超え、次のステップへ進んでいます。 信頼性の高い韓国株データを基盤として、AI が信頼できる回答を提供できるよう支援する新しいサービスを準備しています。開発中の内容をご覧ください。

韓国株分析用の MCP サーバーです。
DART（Data Analysis, Retrieval and Transfer System）および KRX（Korea Exchange）の公式 API を通じて、株価と公示データの AI による分析を可能にします。

💬 ご意見・機能リクエストをお待ちしています！ このツールの使用中に改善案や問題があれば、お気軽にメールでお知らせください。 できるだけ早く確認し、対応します。 📧 [email protected]

🎯 主な機能

• 🔍 公示検索 - 企業名と日付で企業の公示情報を検索します
• 📊 公示データ - 公示報告書の原本から解析したデータを提供します
• 💼 財務諸表分析 - XBRL に基づく詳細な財務データを提供します
• 📈 株式データ - KRX（KOSPI/KOSDAQ）の日次株価と銘柄の基本情報を提供します

⚡ クイックスタート

1️⃣ API KEY の登録

DART と KRX の両方から API KEY を取得する必要があります。

📝 DART API KEY の登録

1. サインアップ：OPEN DART で登録します
2. キーの申請：認証キー申請ページで API KEY を申請します
3. キーの確認：Open API 利用状況で発行された API KEY を確認します

📈 KRX API KEY の登録

1. サインアップ：KRX OPEN APIで登録してログインします

2. キーの申請：マイページ → API 認証キー申請から API 認証キーを申請します

3. サービスの申請：承認後、サービス利用 → 株式メニューに進みます

4. API 利用の申請：以下の 6 項目それぞれについて、「API 利用申請」をクリックします

   • 証券日次取引情報
   • KOSDAQ 日次取引情報
   • KONEX 日次取引情報
   • 証券基本情報
   • KOSDAQ 基本情報
   • KONEX 基本情報

   ⏱️ 承認には約 1 日かかります。

5. キーの確認：承認後、マイページ → API 認証キー発行履歴で API KEY を確認します

2️⃣ Claude Desktop のセットアップ

1. Claude Desktop を起動します
2. Settings → Developer → Edit Configuration に進みます
3. claude_desktop_config.json に以下の内容を追加します：

{
  "mcpServers": {
    "korea-stock-mcp": {
      "command": "npx",
      "args": ["-y", "korea-stock-mcp@latest"],
      "env": {
        "DART_API_KEY": "<YOUR_DART_API_KEY>",
        "KRX_API_KEY": "<YOUR_KRX_API_KEY>"
      }
    }
  }
}

4. 再起動：設定を適用するため、Claude Desktop を再起動します

これで Claude を使って韓国株データの分析を始められます。

大規模な公示文書の処理

一部の公示報告書（年次報告書、四半期報告書など）は、数 MB に及ぶ大きな XML 文書です。 このような文書を一度に処理すると、AI の応答上限を超えたり、エラーが発生したりすることがあります。

どのように動作しますか？

ドキュメントのサイズに応じて、処理方法が自動的に切り替わります。

• 小さいドキュメント（1MB未満）：ドキュメント全体をすぐに返します。
• 大きいドキュメント（1MB以上）：ドキュメント全体の代わりに**目次（TOC）**を返します。Claude が目次を読み、質問に関連するセクションを自動的に選択して取得します。

ユーザーガイド

手動での操作は不要です。 Claude が大きいドキュメントを自動的に処理します。

ドキュメントが大きい場合、Claude は自動的に次の処理を行います。

1. ドキュメントの目次を確認します。
2. 質問に関連するセクションを選択して取得します。
3. 回答後、残りのセクションを一覧表示するので、気になる別のセクションをリクエストできます。

例：

• 「年次報告書から売上の概要を見せて」→ Claude が売上に関連するセクションを自動的に選択します
• 「今表示した目次のセクション 3 も取得して」→ 特定のセクションを直接リクエストできます

💡 複雑な質問は段階に分けてください

一度の質問で望む回答が得られない場合は、質問を小さなステップに分けると、より正確な結果が得られます。

たとえば、「Inventera の有価証券届出書から外国人投資家の割当の詳細を見せて」と一度に尋ねる代わりに、次のようにします。

1. 「Inventera の corp_code を取得して」
2. 「その会社の有価証券発行に関する開示を検索して」
3. 「その開示のドキュメントの内容を取得して」
4. 「外国人投資家の割当表を探して」

この方法なら、各ステップの出力を確認しながら、必要な情報を正確に見つけられるよう Claude を導くことができます。

---

利用可能なツール

DART（データ分析・検索・転送システム）

1. get_disclosure_list - 開示情報検索

   • 種類、会社、日付で開示報告書を検索します

2. get_corp_code - 法人コード照会

   • DART に登録された開示企業の一意のコード、会社名、銘柄コードを提供します
   • 会社名（corp_name）または銘柄コード（stock_code）で検索します
   • 会社名で検索できない場合（韓国語以外の入力など）は、銘柄コードでの再検索を提案します

3. get_disclosure - 開示報告書の内容

   • DART API を通じて、元の開示報告書ファイルを解析します
   • 大きいドキュメントの場合は目次（TOC）を返します。特定のセクションを取得するには section_id を使用します

4. get_financial_statement - 財務諸表

   • 上場企業および主要な非上場企業の XBRL 財務諸表
   • 定期報告書のすべての勘定科目データを提供します

KRX（韓国取引所）

1. get_stock_base_info - 基本株式情報

   • KOSPI、KOSDAQ、KONEX 上場銘柄の基本情報
   • 銘柄名、銘柄コード、市場区分などの基本データ

2. get_stock_trade_info - 日次取引情報

   • KOSPI、KOSDAQ、KONEX 銘柄の日次取引データ
   • 株価、取引量、時価総額などの詳細な取引情報

3. get_market_type - 市場区分照会

   • 銘柄コードから市場区分（KOSPI/KOSDAQ/KONEX）を照会します
   • 株式データの照会に必要な市場情報を提供します

その他のツール

1. get_today_date - 今日の日付照会
   • 現在の日付を YYYYMMDD 形式で提供します
   • AI が正確な日付を照会するためのツールです

実際の使用例

📊 財務分析の例

プロンプト：「2023 年第 1 四半期〜第 4 四半期、2024 年第 1 四半期〜第 4 四半期、2025 年第 1 四半期〜第 2 四半期の Samyang Foods の売上高と営業利益を調べ、成長率も確認して」
→ Samyang Foods の分析結果を見る

プロンプト：「2023 年第 1 四半期から 2025 年第 2 四半期までの APR の売上高と営業利益の成長に加え、株価と時価総額の推移も調べて」 → APR の分析結果を見る

🏢 企業分析の例

プロンプト：「HJ SHIPBUILDING & CONSTRUCTION の収益源と、事業セグメント別の売上高を教えて」 → HJ Shipbuilding & Construction の分析結果を見る

📑 開示分析の例

プロンプト：「IPOの海外割当の詳細を取得する（例：Inventera / 0007J0）」 → Inventera IPOの海外割当分析結果を参照

APIデータソース

• DART（Data Analysis, Retrieval and Transfer System）：上場企業の開示情報および財務諸表
• KRX（Korea Exchange）：株式の基本情報および日次取引情報

ローカル開発とテスト

ソースコードを変更しながらテストする方法です。

1️⃣ 依存関係をインストールする

npm install

2️⃣ 環境変数を設定する

プロジェクトのルートに .env ファイルを作成します。

DART_API_KEY=your_dart_api_key
KRX_API_KEY=your_krx_api_key

3️⃣ MCP Inspector を実行する

npm run inspect

ターミナルに表示された URL（例：http://localhost:6274）をブラウザーで開き、MCP Inspector の UI を表示します。

Inspector で Connect をクリックし、左側のパネルから任意のツールを選択して直接呼び出します。

4️⃣ ソースを変更した後に再テストする

src/ 配下のファイルを保存すると、サーバーが自動的に再起動します。 Inspector で Reconnect をクリックすると、変更がすぐに反映されます。

Note：Node.js 18 以上が必要です。

コントリビューション

コントリビューションを歓迎します。Pull Request をお送りください。

1. このリポジトリをフォークします
2. フィーチャーブランチを作成します（git checkout -b feature/AmazingFeature）
3. 変更をコミットします（git commit -m 'Add some AmazingFeature'）
4. ブランチにプッシュします（git push origin feature/AmazingFeature）
5. Pull Request を作成します

ライセンス

ISC License

サポート

• 🐛 問題が発生した場合は、GitHub Issues に登録してください
• ⭐ 便利だと思ったら、スターを付けてください！

免責事項

このツールは情報提供のみを目的としており、投資助言ではありません。投資判断はすべてご自身の責任で行ってください。