remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Available as a PyPI package that can be installed via the Python package manager to enable the KOSPI/KOSDAQ stock data functionality.

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 サーバーを構成する必要があります。

構成ファイルを見つけます。
- macOS では、ファイルは通常、次の場所にあります: /Users/username/Library/Application Support/Claude/claude_desktop_config.json
- Windows では、ファイルは通常次の場所にあります: %APPDATA%/Claude/claude_desktop_config.json
サーバー構成を追加します。claude_desktop_config.jsonファイルclaude_desktop_config.json開き、 mcpServersオブジェクトに新しいエントリを追加します。

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

構成の詳細:

command : uvxを使用して uv の分離と依存関係の管理を活用する
args : エントリポイントはパッケージ内で定義されているため、パッケージ名のみが必要です。
追加の環境変数は必要ありません

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

使用例

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

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

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.

特定の株の 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
...

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Tools