kospi-kosdaq
코스피-코스닥-주식-서버
FastMCP를 이용해 KOSPI/KOSDAQ 주식 데이터를 제공하는 MCP 서버입니다.
특징
KOSPI/KOSDAQ 티커 기호 및 이름 조회
특정 주식에 대한 OHLCV 데이터 검색
특정 주식의 시가총액 데이터 검색
특정 주식에 대한 기본 데이터(PER/PBR/배당수익률) 검색
특정 주식에 대한 투자자 유형별 거래량 검색
Related MCP server: kookmin-stock
사용 가능한 도구
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 주식 데이터 서버를 자동으로 설치하려면:
지엑스피1
수동 설치
# 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-serverClaude.app 구성
패키지를 설치한 후 claude_desktop_config.json 파일에서 MCP 서버를 구성해야 합니다.
구성 파일을 찾으세요.
macOS에서는 해당 파일이 일반적으로 다음 위치에 있습니다.
/Users/username/Library/Application Support/Claude/claude_desktop_config.jsonWindows에서는 해당 파일이 일반적으로
%APPDATA%/Claude/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를 다시 시작하여 변경 사항을 적용합니다.
사용 예
서버를 구성한 후에는 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
...Available Tools
6 toolsget_index_ohlcvA
Retrieves OHLCV data for a specific index.
Args:
fromdate (str): Start date for retrieval (YYYYMMDD)
todate (str): End date for retrieval (YYYYMMDD)
ticker (str): Index ticker symbol (e.g., 1001 for KOSPI, 2001 for KOSDAQ)
freq (str, optional): d - daily / m - monthly / y - yearly. Defaults to 'd'.
Returns:
DataFrame:
>> get_index_ohlcv("20210101", "20210130", "1001")
Open High Low Close Volume Trading Value
Date
2021-01-04 2874.50 2946.54 2869.11 2944.45 1026510465 25011393960858
2021-01-05 2943.67 2990.57 2921.84 2990.57 1519911750 26548380179493
2021-01-06 2993.34 3027.16 2961.37 2968.21 1793418534 29909396443430
2021-01-07 2980.75 3055.28 2980.75 3031.68 1524654500 27182807334912
2021-01-08 3040.11 3161.11 3040.11 3152.18 1297903388 40909490005818
Inputs: fromdate (required), todate (required), ticker (required), freq.
get_stock_fundamentalA
Retrieves fundamental data (PER/PBR/Dividend Yield) for a specific stock.
Args:
fromdate (str): Start date for retrieval (YYYYMMDD)
todate (str): End date for retrieval (YYYYMMDD)
ticker (str): Stock ticker symbol
Returns:
DataFrame:
>> get_stock_fundamental("20210104", "20210108", "005930")
BPS PER PBR EPS DIV DPS
Date
2021-01-08 37528 28.046875 2.369141 3166 1.589844 1416
2021-01-07 37528 26.187500 2.210938 3166 1.709961 1416
2021-01-06 37528 25.953125 2.189453 3166 1.719727 1416
2021-01-05 37528 26.500000 2.240234 3166 1.690430 1416
2021-01-04 37528 26.218750 2.210938 3166 1.709961 1416
Inputs: fromdate (required), todate (required), ticker (required).
get_stock_market_capA
Retrieves market capitalization data for a specific stock.
Args:
fromdate (str): Start date for retrieval (YYYYMMDD)
todate (str): End date for retrieval (YYYYMMDD)
ticker (str): Stock ticker symbol
Returns:
DataFrame:
>> get_stock_market_cap("20150720", "20150724", "005930")
Market Cap Volume Trading Value Listed Shares
Date
2015-07-24 181030885173000 196584 241383636000 147299337
2015-07-23 181767381858000 208965 259446564000 147299337
2015-07-22 184566069261000 268323 333813094000 147299337
2015-07-21 186039062631000 194055 244129106000 147299337
2015-07-20 187806654675000 128928 165366199000 147299337
Inputs: fromdate (required), todate (required), ticker (required).
get_stock_ohlcvA
Retrieves OHLCV (Open/High/Low/Close/Volume) data for a specific stock.
Args:
fromdate (str): Start date for retrieval (YYYYMMDD)
todate (str): End date for retrieval (YYYYMMDD)
ticker (str): Stock ticker symbol
adjusted (bool, optional): Whether to use adjusted prices (True: adjusted, False: unadjusted). Defaults to True.
Returns:
DataFrame:
>> get_stock_ohlcv("20210118", "20210126", "005930")
Open High Low Close Volume
Date
2021-01-26 89500 94800 89500 93800 46415214
2021-01-25 87300 89400 86800 88700 25577517
2021-01-22 89000 89700 86800 86800 30861661
2021-01-21 87500 88600 86500 88100 25318011
2021-01-20 89000 89000 86500 87200 25211127
2021-01-19 84500 88000 83600 87000 39895044
2021-01-18 86600 87300 84100 85000 43227951
Inputs: fromdate (required), todate (required), ticker (required), adjusted.
get_stock_trading_volumeA
Retrieves trading volume by investor type for a specific stock.
Args:
fromdate (str): Start date for retrieval (YYYYMMDD)
todate (str): End date for retrieval (YYYYMMDD)
ticker (str): Stock ticker symbol
Returns:
DataFrame with columns:
- Volume (Sell/Buy/Net Buy)
- Trading Value (Sell/Buy/Net Buy)
Broken down by investor types (Financial Investment, Insurance, Trust, etc.)
Inputs: fromdate (required), todate (required), ticker (required).
load_all_tickersA
Loads all ticker symbols and names for KOSPI and KOSDAQ into memory.
Returns:
Dict[str, str]: A dictionary mapping tickers to stock names.
Example: {"005930": "삼성전자", "035720": "카카오", ...}
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
Each tool has a clearly distinct purpose with no overlap. get_index_ohlcv retrieves index data, get_stock_ohlcv retrieves stock price data, get_stock_fundamental provides fundamental metrics, get_stock_market_cap gives market capitalization, get_stock_trading_volume shows investor breakdowns, and load_all_tickers provides ticker metadata. The separation between index vs. stock tools and different data types is unambiguous.
All tools follow a consistent verb_noun pattern with 'get_' or 'load_' prefixes. The naming is perfectly uniform: get_index_ohlcv, get_stock_fundamental, get_stock_market_cap, get_stock_ohlcv, get_stock_trading_volume, and load_all_tickers. This consistency makes the tool set predictable and easy to understand.
With 6 tools, this server is well-scoped for financial data retrieval. Each tool serves a specific, necessary function for stock and index analysis without redundancy. The count is ideal for covering core data needs (price, fundamentals, market cap, volume breakdowns, and ticker metadata) without being overwhelming or insufficient.
The tool set covers essential data retrieval for Korean stock market analysis comprehensively, including price data, fundamentals, market cap, trading insights, and ticker information. A minor gap exists in lacking tools for real-time data or more advanced analytics like technical indicators, but the core CRUD-like retrieval operations for the domain are well-covered.
Maintenance
Related MCP Connectors
MCP server for real-time China A-share stock quotes, indices and market data.
MCP server for Financial Modeling Prep API with 250+ financial data tools
MCP server with quote and live cryptocurrency price tools, local and cloud-deployed transports.
Hosted MCP server for Indian market quotes, option-chain Greeks and multi-broker telemetry.
Related MCP Servers
- ISC
- FlicenseAqualityDmaintenanceMCP server that provides Korean stock market data including indices, top gainers, stock quotes, news, fundamentals, and buy recommendations. Enables LLMs to access real-time and historical Korean stock information.6-
- AlicenseAqualityCmaintenanceMCP server wrapping Toss Securities Open API, enabling stock price queries and trading for Korean and US stocks via natural language.3664 npmMIT
- AlicenseAqualityDmaintenanceProvides Korean stock market data, including DART electronic disclosures and KRX trading information, enabling users to query company profiles, financial statements, and stock trade details via MCP clients.9MIT