Shioaji の MCP サーバー
AI アシスタントに台湾金融市場の Shioaji 取引 API へのアクセスを提供するモデル コンテキスト プロトコル (MCP) サーバー。
概要
このサーバーはMCPプロトコルを実装し、Shioaji API機能をAIアシスタントが利用できるツールとして公開します。これにより、AIモデルは以下のことが可能になります。
現在の株価を取得する
履歴データを取得する
利用可能な在庫を一覧表示する
さらに…
Related MCP server: Trading Simulator 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デコレータを使用して新しいツール定義を追加します。
ライセンス
マサチューセッツ工科大学