Skip to main content
Glama
kospi-kosdaq

kospi-kosdaq

by dragon1086

코스피-코스닥-주식-서버

PyPI 버전 대장간 배지

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-server

Claude.app 구성

패키지를 설치한 후 claude_desktop_config.json 파일에서 MCP 서버를 구성해야 합니다.

  1. 구성 파일을 찾으세요.

    • macOS에서는 해당 파일이 일반적으로 다음 위치에 있습니다. /Users/username/Library/Application Support/Claude/claude_desktop_config.json

    • Windows에서는 해당 파일이 일반적으로 %APPDATA%/Claude/claude_desktop_config.json 에 있습니다.

  2. 서버 구성을 추가합니다. claude_desktop_config.json 파일을 열고 mcpServers 개체에 새 항목을 추가합니다.

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

구성 세부 정보:

  • command : uvx 사용하여 uv의 격리 및 종속성 관리를 활용하세요

  • args : 진입점이 패키지에 정의되어 있으므로 패키지 이름만 필요합니다.

  • 추가 환경 변수가 필요하지 않습니다.

  1. Claude를 다시 시작합니다. claude_desktop_config.json 에 대한 변경 사항을 저장한 후 Claude를 다시 시작하여 변경 사항을 적용합니다.

사용 예

서버를 구성한 후에는 Claude에서 다음과 같이 사용할 수 있습니다.

  1. 먼저, 사용 가능한 모든 주식 티커를 로드합니다.

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.
  1. 특정 주식에 대한 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 tools
get_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

    A4.1/5.0

    Scored across 6 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivityStale
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      A
      quality
      D
      maintenance
      MCP 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
      -
    • A
      license
      A
      quality
      C
      maintenance
      MCP server wrapping Toss Securities Open API, enabling stock price queries and trading for Korean and US stocks via natural language.
      36
      64 npm
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Provides 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.
      9
      MIT