kospi-kosdaq

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

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

수동 설치

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 개체에 새 항목을 추가합니다.

구성 세부 정보:

• command : uvx 사용하여 uv의 격리 및 종속성 관리를 활용하세요
• args : 진입점이 패키지에 정의되어 있으므로 패키지 이름만 필요합니다.
• 추가 환경 변수가 필요하지 않습니다.

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

사용 예

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

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

2. 특정 주식에 대한 OHLCV 데이터 가져오기: