kospi-kosdaq-stock-server
An MCP server that provides KOSPI/KOSDAQ stock data from KRX Data Marketplace.
接入你的智能体
从发布者处安装。不是 PlugMCP 端点。
远程 URL 还是本机命令? 两种安装方式的区别
Since December 27, 2024, KRX Data Marketplace requires Kakao/Naver login for data access. This version implements:
# Required: Kakao login credentials
KAKAO_ID=your_kakao_id
KAKAO_PW=your_kakao_password
Important: Your Kakao account must have 2-step verification (2FA) disabled. On first login, you may need to approve the login request via KakaoTalk.
# Install Playwright and Chromium browser
pip install playwright
playwright install chromium
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
# Install Playwright browser
playwright install chromium
code ~/Library/Application\ Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"kospi-kosdaq": {
"command": "uvx",
"args": ["kospi_kosdaq_stock_server"],
"env": {
"KAKAO_ID": "your_kakao_id",
"KAKAO_PW": "your_kakao_password"
}
}
}
}
Open the config file at %APPDATA%/Claude/claude_desktop_config.json
Add the same configuration as above
Restart Claude Desktop
load_all_tickersLoads all ticker symbols and names for KOSPI and KOSDAQ.
get_stock_ohlcvRetrieves OHLCV (Open/High/Low/Close/Volume) data for a specific stock.
fromdate (string, required): Start date (YYYYMMDD)todate (string, required): End date (YYYYMMDD)ticker (string, required): Stock ticker symbol (e.g., "005930")adjusted (boolean, optional): Use adjusted prices (default: True)get_stock_market_capRetrieves market capitalization data for a specific stock.
fromdate (string, required): Start date (YYYYMMDD)todate (string, required): End date (YYYYMMDD)ticker (string, required): Stock ticker symbolget_stock_fundamentalRetrieves fundamental data (PER/PBR/Dividend Yield) for a specific stock.
fromdate (string, required): Start date (YYYYMMDD)todate (string, required): End date (YYYYMMDD)ticker (string, required): Stock ticker symbolget_stock_trading_volumeRetrieves trading volume by investor type for a specific stock.
fromdate (string, required): Start date (YYYYMMDD)todate (string, required): End date (YYYYMMDD)ticker (string, required): Stock ticker symboldetail (boolean, optional): If true, returns 12 investor types; if false (default), returns 5 aggregated typesget_index_ohlcvRetrieves OHLCV data for market indices.
fromdate (string, required): Start date (YYYYMMDD)todate (string, required): End date (YYYYMMDD)ticker (string, required): Index ticker (e.g., "1001" for KOSPI, "2001" for KOSDAQ)freq (string, optional): Frequency - "d" (daily), "m" (monthly), "y" (yearly). Default: "d"stock://tickersReturns all KOSPI/KOSDAQ ticker symbols and names.
stock://index-tickersReturns index ticker information:
stock://data-sourcesReturns current data source status.
# Build and run
docker-compose up -d
# View logs
docker-compose logs -f
Create a .env file:
KAKAO_ID=your_kakao_id
KAKAO_PW=your_kakao_password
On first login, Kakao may require approval via KakaoTalk:
headless=False to see the browserSession expires after ~4 hours. The server auto-renews, but if it fails:
~/.krx_session.json# Install required packages on Ubuntu/Debian
apt-get install -y libnss3 libatk1.0-0 libatk-bridge2.0-0 libcups2 libdrm2 \
libxkbcommon0 libxcomposite1 libxdamage1 libxfixes3 libxrandr2 libgbm1 libasound2
┌─────────────────────────────────────────────────────┐
│ MCP Server (FastMCP) │
│ kospi_kosdaq_stock_server.py │
└──────────────────────┬──────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────┐
│ KRXDataClient │
│ - get_market_ohlcv() │
│ - get_market_cap() │
│ - get_market_fundamental() │
│ - get_market_trading_volume_by_date() │
│ - get_index_ohlcv() │
└──────────────────────┬──────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────┐
│ KakaoAuthManager │
│ - Playwright headless browser │
│ - Kakao OAuth login │
│ - Session cookie management │
│ - Auto re-login on session expiry (4h) │
└──────────────────────┬──────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────┐
│ KRX Data Marketplace │
│ data.krx.co.kr │
└─────────────────────────────────────────────────────┘
Human: Please load all available stock tickers.
Assistant: I'll load all KOSPI and KOSDAQ stock tickers.
> Using tool 'load_all_tickers'...
Successfully loaded 2,738 stock tickers.
Human: Show me Samsung Electronics' stock data for December 2024.
Assistant: I'll retrieve Samsung Electronics' (005930) OHLCV data.
> Using tool 'get_stock_ohlcv'...
Date Open High Low Close Volume
2024-12-20 53,800 54,200 53,500 53,900 8,234,521
2024-12-19 54,000 54,300 53,700 53,800 7,123,456
...
MIT License
Issues and pull requests are welcome!
An MCP server that provides KOSPI/KOSDAQ stock data using FastMCP
工具
暂无工具列表。远程服务器在首次健康检查后会获得工具列表。
常见问题
在本页复制适用于 Cursor、Claude Desktop、Claude Code 或 VS Code 的 stdio 配置。它使用发布者的安装方式,而不是 PlugMCP 代理。
此记录未列出必需的环境变量。
Kospi Kosdaq Stock Server 通过 stdio 在本地运行。
上次检查时间:2026-10-27。 An MCP server that provides KOSPI/KOSDAQ stock data using FastMCP