MCP Server Shioaji

🚀 ShioajiのMCPサーバー

このサーバーは、モデルコンテキストプロトコル（MCP）を実装し、AIアシスタントに台湾金融市場のShioaji取引APIへのアクセス機能を提供します。

🚀 クイックスタート

このサーバーはMCPプロトコルを通じてShioaji APIの機能をサポートし、AIモデルが以下のことを行えるようにします。

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

📦 インストール

前提条件

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

uvを使用する

uv sync

📚 ドキュメント

設定

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

環境変数

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

export SHIOAJI_API_KEY="あなたのAPIキー"
export SHIOAJI_SECRET_KEY="あなたのシークレットキー"

.envファイルを使用する

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

SHIOAJI_API_KEY=あなたのAPIキー
SHIOAJI_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"
  }
}