Shioaji용 MCP 서버

대만 금융 시장을 위한 Shioaji 거래 API에 대한 접근을 AI 보조원에게 제공하는 MCP(Model Context Protocol) 서버입니다.

개요

이 서버는 MCP 프로토콜을 구현하여 Shioaji API 기능을 AI 어시스턴트가 사용할 수 있는 도구로 제공합니다. 이를 통해 AI 모델은 다음과 같은 작업을 수행할 수 있습니다.

• 현재 주가를 검색합니다

• 과거 데이터 가져오기

• 사용 가능한 주식 목록

• 그리고 더 많은 것...

Related MCP server: Financial Datasets MCP Server

설치

필수 조건

• Python 3.10 이상

• uv(빠른 Python 패키지 관리자)

uv를 사용하여

지엑스피1

구성

서버를 실행하기 전에 Shioaji API 자격 증명을 구성해야 합니다. 두 가지 방법이 있습니다.

환경 변수

다음 환경 변수를 설정하세요.

export SHIOAJI_API_KEY="your_api_key"
export SHIOAJI_SECRET_KEY="your_secret_key"

.env 파일 사용

루트 디렉토리에 다음 내용으로 .env 파일을 만듭니다.

SHIOAJI_API_KEY=your_api_key
SHIOAJI_SECRET_KEY=your_secret_key

서버 실행

다음을 사용하여 서버를 시작합니다.

uv run mcp-server-shioaji

서버는 기본적으로 http://0.0.0.0:8000 에서 시작됩니다.

사용 가능한 도구

서버는 MCP를 통해 다음 도구를 제공합니다.

주가를 얻으세요

주식의 기호를 통해 현재 가격을 알아보세요.

{
  "tool": "get_stock_price",
  "params": {
    "symbols": "TW.2330,TW.2317"
  }
}

응답에는 요청된 주식의 가격 정보(시가, 고가, 저가, 종가, 거래량 및 기타 거래 데이터 포함)가 포함됩니다.

get_kbars

특정 날짜 범위 내의 주식에 대한 K-Bar(캔들스틱) 데이터를 가져옵니다.

{
  "tool": "get_kbars",
  "params": {
    "symbol": "TW.2330",
    "start_date": "2023-12-01",
    "end_date": "2023-12-15"
  }
}

start_date 지정하지 않으면 오늘로 기본 설정됩니다. end_date 지정하지 않으면 start_date 와 동일한 날짜로 기본 설정됩니다.

스캔_스톡

다양한 순위 기준에 따라 주식을 스캔합니다.

{
  "tool": "scan_stocks",
  "params": {
    "scanner_type": "VolumeRank",
    "ascending": false,
    "limit": 10
  }
}

지원되는 스캐너 유형:

• VolumeRank - 거래량별 순위

• AmountRank - 거래 금액별 순위

• TickCountRank - 거래 수에 따른 순위

• ChangePercentRank - 백분율 변화로 순위 매기기

• ChangePriceRank - 가격 변동에 따른 순위

• DayRangeRank - 일일 범위별 순위

기본 제한은 20이고, 결과는 기본적으로 내림차순으로 정렬됩니다(오름차순으로 정렬하려면 ascending true 로 설정합니다).

개발

프로젝트 구조

mcp-server-shioaji/
├── src/
│   └── mcp_server_shioaji/
│       ├── __init__.py      # Package entry point
│       └── server.py        # MCP server implementation
├── pyproject.toml           # Project metadata and dependencies
└── README.md                # This file

새로운 도구 추가

새로운 Shioaji 기능을 추가하려면 server.py 수정하고 @mcp.tool 데코레이터를 사용하여 새로운 도구 정의를 추가합니다.

특허

MIT

감사의 말

• Shioaji - SinoPac의 거래 API를 위한 Python 래퍼

• MCP - 모델 컨텍스트 프로토콜