Shioaji の MCP サーバー

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

概要

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

• 現在の株価を取得する

• 履歴データを取得する

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

• さらに…

Related MCP server: Trading Simulator MCP Server

インストール

前提条件

• Python 3.10以上

• uv (高速 Python パッケージ マネージャー)

UVの使用

構成

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

環境変数

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

.env ファイルの使用

ルート ディレクトリに次の内容の.envファイルを作成します。

サーバーの実行

次のコマンドでサーバーを起動します。

デフォルトでは、サーバーはhttp://0.0.0.0:8000で起動します。

利用可能なツール

サーバーは、MCP を介して次のツールを公開します。

株価を取得する

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

応答には、始値、高値、安値、終値、出来高、その他の取引データなど、要求された株式の価格情報が含まれます。

get_kbars

日付範囲内の株式の K バー (ローソク足) データを取得します。

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

スキャンストック

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

サポートされているスキャナーの種類:

• VolumeRank - 取引量によるランキング

• AmountRank - 取引額によるランキング

• TickCountRank - 取引数によるランキング

• ChangePercentRank - パーセンテージの変化によるランキング

• ChangePriceRank - 価格変動によるランキング

• DayRangeRank - 日別範囲によるランキング

デフォルトの制限は 20 で、結果はデフォルトで降順で並べ替えられます (昇順の場合はascending trueに設定します)。

発達

プロジェクト構造

新しいツールの追加

新しい Shioaji 機能を追加するには、 server.py変更し、 @mcp.toolデコレータを使用して新しいツール定義を追加します。

ライセンス

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

謝辞

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

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