kospi-kosdaq-stock-server

FastMCPを利用してKOSPI/KOSDAQ株価データを提供するMCPサーバーです。

特徴

• KOSPI/KOSDAQのティッカーシンボルと名称を検索

• 特定の銘柄のOHLCVデータを取得する

• 特定の株式の時価総額データを取得する

• 特定の株式のファンダメンタルデータ（PER/PBR/配当利回り）を取得します

• 特定の株式の投資家タイプ別の取引量を取得する

利用可能なツール

• load_all_tickers - KOSPI および KOSDAQ のすべてのティッカーシンボルと名前をメモリに読み込みます。

  • 議論はありません。

• get_stock_ohlcv - 特定の株の OHLCV (始値/高値/安値/終値/出来高) データを取得します。

  • fromdate (文字列、必須): 取得開始日 (YYYYMMDD)

  • todate (文字列、必須): 取得の終了日 (YYYYMMDD)

  • ticker (文字列、必須): 株式ティッカーシンボル

  • adjusted （ブール値、オプション）：調整済み価格を使用するかどうか（True：調整済み、False：未調整）。デフォルトはTrueです。

• get_stock_market_cap - 特定の株式の時価総額データを取得します。

  • fromdate (文字列、必須): 取得開始日 (YYYYMMDD)

  • todate (文字列、必須): 取得の終了日 (YYYYMMDD)

  • ticker (文字列、必須): 株式ティッカーシンボル

• get_stock_fundamental - 特定の株式の基本データ (PER/PBR/配当利回り) を取得します。

  • fromdate (文字列、必須): 取得開始日 (YYYYMMDD)

  • todate (文字列、必須): 取得の終了日 (YYYYMMDD)

  • ticker (文字列、必須): 株式ティッカーシンボル

• get_stock_trading_volume - 特定の株式の投資家タイプ別の取引量を取得します。

  • fromdate (文字列、必須): 取得開始日 (YYYYMMDD)

  • todate (文字列、必須): 取得の終了日 (YYYYMMDD)

  • ticker (文字列、必須): 株式ティッカーシンボル

インストール

このパッケージのインストールと実行にはuvが必要です。

Smithery経由でインストール

Smithery経由で Claude Desktop 用の KOSPI/KOSDAQ 株価データ サーバーを自動的にインストールするには:

npx -y @smithery/cli install @dragon1086/kospi-kosdaq-stock-server --client claude

手動インストール

# Create and activate a virtual environment
uv venv .venv
source .venv/bin/activate  # On Unix/macOS
# .venv\Scripts\activate   # On Windows

# Install the package
uv pip install kospi-kosdaq-stock-server

Claude.app の設定

パッケージをインストールした後、 claude_desktop_config.jsonファイルで MCP サーバーを構成する必要があります。

1. 構成ファイルを見つけます。

   • macOS では、ファイルは通常、次の場所にあります: /Users/username/Library/Application Support/Claude/claude_desktop_config.json

   • Windows では、ファイルは通常次の場所にあります: %APPDATA%/Claude/claude_desktop_config.json

2. サーバー構成を追加します。claude_desktop_config.jsonファイルclaude_desktop_config.json開き、 mcpServersオブジェクトに新しいエントリを追加します。

{
    "mcpServers": {
        "kospi-kosdaq": {
            "command": "uvx",
            "args": ["kospi_kosdaq_stock_server"]
        }
    }
}

構成の詳細:

• command : uvxを使用して uv の分離と依存関係の管理を活用する

• args : エントリポイントはパッケージ内で定義されているため、パッケージ名のみが必要です。

• 追加の環境変数は必要ありません

3. Claude を再起動します。claude_desktop_config.json claude_desktop_config.jsonの変更を保存した後、変更を有効にするために Claude を再起動します。

使用例

サーバーを設定したら、次のように Claude で使用できます。

1. まず、利用可能なすべての株価ティッカーを読み込みます。

Human: Please load all available stock tickers.
Assistant: I'll help you load all KOSPI and KOSDAQ stock tickers.

> Using tool 'load_all_tickers'...
Successfully loaded 2,873 stock tickers.

2. 特定の株の OHLCV データを取得します。

Human: Show me Samsung Electronics' stock data for the last month.
Assistant: I'll retrieve Samsung Electronics' (005930) OHLCV data for the last month.

> Using tool 'get_stock_ohlcv'...
Date        Open    High    Low     Close   Volume
2024-02-14  73,800  74,000  73,400  73,700  7,823,124
2024-02-13  73,600  74,200  73,200  73,800  8,943,217
...