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

Provides configuration management for Shioaji API credentials through a .env file, allowing secure storage of API and secret keys.
Serves as the runtime environment for the MCP server that interfaces with the Shioaji trading API, enabling financial market data access for Taiwan stocks.

Shioaji용 MCP 서버

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

개요

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

현재 주가를 검색합니다
과거 데이터 가져오기
사용 가능한 주식 목록
그리고 더 많은 것...

설치

필수 조건

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 - 모델 컨텍스트 프로토콜

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested