Shioaji용 MCP 서버
대만 금융 시장을 위한 Shioaji 거래 API에 대한 접근을 AI 보조원에게 제공하는 MCP(Model Context Protocol) 서버입니다.
개요
이 서버는 MCP 프로토콜을 구현하여 Shioaji API 기능을 AI 어시스턴트가 사용할 수 있는 도구로 제공합니다. 이를 통해 AI 모델은 다음과 같은 작업을 수행할 수 있습니다.
현재 주가를 검색합니다
과거 데이터 가져오기
사용 가능한 주식 목록
그리고 더 많은 것...
Related MCP server: Trading Simulator MCP Server
설치
필수 조건
Python 3.10 이상
uv(빠른 Python 패키지 관리자)
uv를 사용하여
지엑스피1
구성
서버를 실행하기 전에 Shioaji API 자격 증명을 구성해야 합니다. 두 가지 방법이 있습니다.
환경 변수
다음 환경 변수를 설정하세요.
.env 파일 사용
루트 디렉토리에 다음 내용으로 .env 파일을 만듭니다.
서버 실행
다음을 사용하여 서버를 시작합니다.
서버는 기본적으로 http://0.0.0.0:8000 에서 시작됩니다.
사용 가능한 도구
서버는 MCP를 통해 다음 도구를 제공합니다.
주가를 얻으세요
주식의 기호를 통해 현재 가격을 알아보세요.
응답에는 요청된 주식의 가격 정보(시가, 고가, 저가, 종가, 거래량 및 기타 거래 데이터 포함)가 포함됩니다.
get_kbars
특정 날짜 범위 내의 주식에 대한 K-Bar(캔들스틱) 데이터를 가져옵니다.
start_date 지정하지 않으면 오늘로 기본 설정됩니다. end_date 지정하지 않으면 start_date 와 동일한 날짜로 기본 설정됩니다.
스캔_스톡
다양한 순위 기준에 따라 주식을 스캔합니다.
지원되는 스캐너 유형:
VolumeRank- 거래량별 순위AmountRank- 거래 금액별 순위TickCountRank- 거래 수에 따른 순위ChangePercentRank- 백분율 변화로 순위 매기기ChangePriceRank- 가격 변동에 따른 순위DayRangeRank- 일일 범위별 순위
기본 제한은 20이고, 결과는 기본적으로 내림차순으로 정렬됩니다(오름차순으로 정렬하려면 ascending true 로 설정합니다).
개발
프로젝트 구조
새로운 도구 추가
새로운 Shioaji 기능을 추가하려면 server.py 수정하고 @mcp.tool 데코레이터를 사용하여 새로운 도구 정의를 추가합니다.
특허
MIT