MCP Server for Shioaji

Shioaji 用 MCP サーバー

台湾の金融市場向けに、AI アシスタントが Shioaji 取引 API を利用できるようにする Model Context Protocol（MCP）サーバーです。

概要

このサーバーは MCP プロトコルを実装し、Shioaji API の機能を AI アシスタントが利用できるツールとして公開します。AI モデルは次の操作を行えます。

• 現在の株価を取得する
• 過去のデータを取得する
• 利用可能な銘柄を一覧表示する
• その他...

インストール

前提条件

• Python 3.10 以降
• uv（高速な Python パッケージマネージャー）

uv を使用する場合

uv sync

設定

サーバーを起動する前に、Shioaji API の認証情報を設定する必要があります。設定方法は 2 つあります。

環境変数

次の環境変数を設定します。

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 を通じて次のツールを公開します。

get_stock_price

銘柄コードを指定して、株価を取得します。

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

レスポンスには、指定した銘柄の始値、高値、安値、終値、出来高などの取引データが含まれます。

get_kbars

指定した期間の銘柄の K バー（ローソク足）データを取得します。

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

start_date が指定されていない場合は、今日がデフォルト値になります。end_date が指定されていない場合は、start_date と同じ値がデフォルトになります。

scan_stocks

さまざまなランキング基準に基づいて銘柄をスキャンします。

{
  "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 - Model Context Protocol