remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Available as a PyPI package that can be installed via the Python package manager to enable the KOSPI/KOSDAQ stock data functionality.

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

FastMCP를 이용해 KOSPI/KOSDAQ 주식 데이터를 제공하는 MCP 서버입니다.

특징

KOSPI/KOSDAQ 티커 기호 및 이름 조회
특정 주식에 대한 OHLCV 데이터 검색
특정 주식의 시가총액 데이터 검색
특정 주식에 대한 기본 데이터(PER/PBR/배당수익률) 검색
특정 주식에 대한 투자자 유형별 거래량 검색

사용 가능한 도구

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 서버를 구성해야 합니다.

구성 파일을 찾으세요.
- macOS에서는 해당 파일이 일반적으로 다음 위치에 있습니다. /Users/username/Library/Application Support/Claude/claude_desktop_config.json
- Windows에서는 해당 파일이 일반적으로 %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
...

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Tools