kospi-kosdaq-stock-server
An MCP server that provides KOSPI/KOSDAQ stock data from KRX Data Marketplace.
Power your agent
การติดตั้งจากผู้เผยแพร่ ไม่ใช่เอนด์พอยต์ของ PlugMCP
URL แบบรีโมตหรือคำสั่งบนเครื่องของคุณ? การติดตั้งสองแบบต่างกันอย่างไร
รันบน PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
เปิด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
เครื่องมือ
ยังไม่มีรายการเครื่องมือ เซิร์ฟเวอร์แบบรีโมตจะได้รายการหลังการตรวจสอบสถานะครั้งแรก
FAQ
คัดลอกคอนฟิก stdio สำหรับ Cursor, Claude Desktop, Claude Code หรือ VS Code ได้ในหน้านี้ คอนฟิกนี้ใช้การติดตั้งของผู้เผยแพร่ ไม่ใช่พร็อกซีของ PlugMCP
ระเบียนนี้ไม่ได้ระบุตัวแปรสภาพแวดล้อมที่จำเป็น
Kospi Kosdaq Stock Server ทำงานแบบโลคัลผ่าน stdio
ตรวจสอบล่าสุดเมื่อ 2026-10-27 An MCP server that provides KOSPI/KOSDAQ stock data using FastMCP