kospi-kosdaq-stock-server

Name: kospi-kosdaq-stock-server
Author: dragon1086

@dragon1086

リポジトリ

kospi-kosdaq-stock-server について

An MCP server that provides KOSPI/KOSDAQ stock data using FastMCP

#finance

基本情報

カテゴリ

金融とコマース

ライセンス

MIT

ランタイム

python

トランスポート

stdio

公開者

dragon1086

設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

{
  "mcpServers": {
    "kospi-kosdaq-stock-server": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli",
        "install",
        "@dragon1086/kospi-kosdaq-stock-server",
        "--client",
        "claude"
      ]
    }
  }
}

ツール

ツールは検出されませんでした

ツールは README から自動的に抽出されます。メンテナーは ## Tools という見出しの下に記載することで、このタブに反映できます。

概要

What is kospi-kosdaq-stock-server?

An MCP server that provides KOSPI/KOSDAQ stock data from the KRX Data Marketplace. It retrieves OHLCV, market capitalization, fundamental data (PER/PBR/Dividend Yield), trading volume by investor type, and index data. Designed for users who need Korean stock market data via AI assistants like Claude Desktop.

How to use kospi-kosdaq-stock-server?

Install via Smithery (npx -y @smithery/cli install @dragon1086/kospi-kosdaq-stock-server --client claude) or manually (uv pip install kospi-kosdaq-stock-server and playwright install chromium). Set environment variables KAKAO_ID and KAKAO_PW (Kakao account with 2FA disabled). Add a server configuration to Claude Desktop’s claude_desktop_config.json. Tools include load_all_tickers, get_stock_ohlcv, get_stock_market_cap, get_stock_fundamental, get_stock_trading_volume, and get_index_ohlcv.

Key features of kospi-kosdaq-stock-server

Lookup KOSPI/KOSDAQ ticker symbols and names
Retrieve OHLCV data for individual stocks
Market capitalization and fundamental data (PER/PBR/Dividend Yield)
Trading volume breakdown by investor type
Index OHLCV for KOSPI, KOSDAQ, and sub-indices
Kakao OAuth authentication via headless browser (Playwright)
Automatic session management with 4-hour timeout and auto re-login

Use cases of kospi-kosdaq-stock-server

Load all Korean stock tickers for reference
Get historical price and volume data for a specific stock (e.g., Samsung Electronics)
Fetch market cap and fundamental metrics for investment analysis
Retrieve index trends for KOSPI or KOSDAQ

FAQ from kospi-kosdaq-stock-server

What are the runtime requirements?

Python 3.10+, a Kakao account with 2FA disabled, and the Playwright Chromium browser installed.

How do I handle the “KakaoTalk login notification” on first run?

Run the server with headless=False to see the browser, approve the login request in KakaoTalk, and the session cookies will be saved for future use.