Shioaji の MCP サーバー

AI アシスタントに台湾金融市場の Shioaji 取引 API へのアクセスを提供するモデル コンテキスト プロトコル (MCP) サーバー。

概要

このサーバーはMCPプロトコルを実装し、Shioaji API機能をAIアシスタントが利用できるツールとして公開します。これにより、AIモデルは以下のことが可能になります。

• 現在の株価を取得する

• 履歴データを取得する

• 利用可能な在庫を一覧表示する

• さらに…

Related MCP server: Financial Datasets MCP Server

インストール

前提条件

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

株価を取得する

銘柄コードから株の現在の価格を取得します。

{
  "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 が指定されていない場合は、 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デコレータを使用して新しいツール定義を追加します。

ライセンス

マサチューセッツ工科大学

謝辞

• Shioaji - SinoPac の取引 API の Python ラッパー

• MCP - モデルコンテキストプロトコル