🚀 韓国株式MCPサーバー

🇰🇷 韓国語 | 🇺🇸 英語

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

✨ 主な機能

• 🔍 公開情報検索 - 会社ごと、期間ごとに公開情報を検索できます。
• 📊 公開データ - 公開報告書のオリジナルファイルを解析したデータを提供します。
• 💼 財務諸表分析 - XBRLに基づく詳細な財務データを提供します。
• 📈 株式データ - KRX（コスピ/コスダック）の日別株価情報、銘柄の基本情報を提供します。

🚀 クイックスタート

1️⃣ APIキーの取得

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

📝 DART APIキーの取得

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

📈 KRX APIキーの取得

1. 会員登録：KRX OPEN APIで会員登録し、ログインします。

2. キー申請：マイページ → API認証キー申請で申請します。

3. サービス申請：承認後、サービス利用 → 株式メニューに移動します。

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

   • 有価証券日別売買情報
   • コスダック日別売買情報
   • コネクス日別売買情報
   • 有価証券銘柄基本情報
   • コスダック銘柄基本情報
   • コネクス銘柄基本情報

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

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

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で韓国株式データの分析を開始できます。

💻 使用例

基本的な使用法

{
  "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>"
      }
    }
  }
}

高度な使用法

// 高度なシナリオでの設定例
{
  "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>"
      },
      "additionalSettings": {
        "someAdvancedOption": "value"
      }
    }
  }
}

📚 ドキュメント

使用可能なツール

DART（電子公開システム）

1. get_disclosure_list - 公開情報検索
   • 公開タイプ、会社、日付別に公開報告書を検索します。
2. get_corp_code - 固有番号照会
   • DART登録公開対象会社の固有番号、会社名、銘柄コードを提供します。
3. get_disclosure - 公開報告書原文
   • DART APIを通じて公開報告書のオリジナルファイルを解析します。
4. get_financial_statement - 財務諸表
   • 上場法人および主要非上場法人のXBRL財務諸表を提供します。
   • 定期報告書内のすべての勘定科目データを提供します。

KRX（韓国取引所）

1. get_stock_base_info - 銘柄基本情報
   • コスピ、コスダック、コネクス上場銘柄の基本情報を提供します。
   • 銘柄名、銘柄コード、市場区分などの基本データを提供します。
2. get_stock_trade_info - 日別売買情報
   • コスピ、コスダック、コネクス銘柄別の日別取引データを提供します。
   • 株価、取引量、時価総額などの詳細な取引情報を提供します。
3. get_market_type - 市場区分照会
   • 銘柄コードで該当銘柄の市場区分（コスピ/コスダック/コネクス）を照会します。
   • 株式データ照会時に必要な市場情報を提供します。

その他のツール

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

実際の使用例

📊 財務分析例

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

プロンプト：「APRの2023年第1四半期から2025年第2四半期までの売上、営業利益の成長と株価、時価総額の動向を調査してください」
→ APR分析結果を見る

🏢 企業分析例

プロンプト：「HJ重工業は何をしてお金を稼いでいるのか、事業部門別の売上も含めて教えてください」
→ HJ重工業分析結果を見る

APIデータソース

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

🔧 技術詳細

本サーバーはDARTとKRXの公式APIを利用して、株式データと公開データを取得します。取得したデータは解析され、Claudeを通じてユーザーに提供されます。具体的な技術的な実装には、APIキーを用いた認証、JSON形式のデータの解析、およびClaude Desktopとの連携が含まれます。

📄 ライセンス

ISCライセンス

サポート

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

免責事項

このツールは情報提供を目的としており、投資アドバイスではありません。すべての投資判断は自己責任で行ってください。

English Version

MCP Server for Korean stock analysis.
Enables AI-powered analysis of stock prices and disclosure data through official APIs from DART (Data Analysis, Retrieval and Transfer System) and KRX (Korea Exchange).

🎯 Key Features

• 🔍 Disclosure Search - Search corporate disclosures by company and date
• 📊 Disclosure Data - Provides parsed data from original disclosure reports
• 💼 Financial Statement Analysis - Detailed financial data based on XBRL
• 📈 Stock Data - KRX (KOSPI/KOSDAQ) daily stock prices and basic stock information

⚡ Quick Start

1️⃣ API KEY Registration

You need to obtain API KEYs from both DART and KRX.

📝 DART API KEY Registration

1. Sign Up: Register at OPEN DART
2. Request Key: Apply for API KEY at Authentication Key Application Page
3. Check Key: Verify issued API KEY at Open API Usage Status

📈 KRX API KEY Registration

1. Sign Up: Register and login at KRX OPEN API

2. Request Key: Apply for API authentication key in My Page → API Authentication Key Application

3. Service Application: After approval, go to Service Use → Stock menu

4. API Usage Application: Click "API Usage Application" for each of the following 6 items

   • Securities Daily Trading Information
   • KOSDAQ Daily Trading Information
   • KONEX Daily Trading Information
   • Securities Basic Information
   • KOSDAQ Basic Information
   • KONEX Basic Information

   ⏱️ Approval takes approximately 1 day.

5. Key Verification: After approval, check API KEY in My Page → API Authentication Key Issuance History

2️⃣ Claude Desktop Setup

1. Launch Claude Desktop
2. Go to Settings → Developer → Edit Configuration
3. Add the following content to 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. Restart: Restart Claude Desktop to apply settings

You can now start analyzing Korean stock data with Claude.

Available Tools

DART (Data Analysis, Retrieval and Transfer System)

1. get_disclosure_list - Disclosure Search

   • Search disclosure reports by type, company, and date

2. get_corp_code - Corporate Code Inquiry

   • Provides unique codes, company names, and stock codes of DART-registered disclosure companies

3. get_disclosure - Disclosure Report Content

   • Parse original disclosure report files through DART API

4. get_financial_statement - Financial Statements

   • XBRL financial statements for listed and major unlisted companies
   • Provides all account data from periodic reports

KRX (Korea Exchange)

1. get_stock_base_info - Basic Stock Information

   • Basic information for KOSPI, KOSDAQ, and KONEX listed stocks
   • Basic data including stock names, codes, and market classifications

2. get_stock_trade_info - Daily Trading Information

   • Daily trading data for KOSPI, KOSDAQ, and KONEX stocks
   • Detailed trading information including stock prices, trading volume, and market capitalization

3. get_market_type - Market Type Inquiry

   • Query market classification (KOSPI/KOSDAQ/KONEX) by stock code
   • Provides market information needed for stock data queries

Other Tools

1. get_today_date - Today's Date Inquiry
   • Provides current date in YYYYMMDD format
   • Tool for AI's accurate date inquiry

Real Usage Examples

📊 Financial Analysis Examples

Prompt: "Investigate Samyang Foods's sales and operating profit for Q1-Q4 2023, Q1-Q4 2024, and Q1-Q2 2025, and also check growth rates"
→ See Samyang Foods Analysis Results

Prompt: "Investigate APR's sales and operating profit growth from Q1 2023 to Q2 2025, along with stock price and market cap trends"
→ See APR Analysis Results

🏢 Corporate Analysis Examples

Prompt: "Tell me what HJ SHIPBUILDING & CONSTRUCTION does to make money and include sales by business segment"
→ See HJ SHIPBUILDING & CONSTRUCTION Analysis Results

API Data Sources

• DART (Data Analysis, Retrieval and Transfer System): Listed company disclosure information and financial statements
• KRX (Korea Exchange): Basic stock information and daily trading information

Contributing

Contributions are welcome! Please send us a Pull Request.

1. Fork this repository
2. Create a feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

License

ISC License

Support

• 🐛 If you have issues, please register them in GitHub Issues
• ⭐ If you find it useful, please give it a star!

Disclaimer

This tool is for informational purposes only and is not investment advice. All investment decisions are your own responsibility.