remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Provides configuration management for Shioaji API credentials through a .env file, allowing secure storage of API and secret keys.
Serves as the runtime environment for the MCP server that interfaces with the Shioaji trading API, enabling financial market data access for Taiwan stocks.

Shioaji の MCP サーバー

AI アシスタントに台湾金融市場の Shioaji 取引 API へのアクセスを提供するモデルコンテキストプロトコル (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 を介して次のツールを公開します。

株価を取得する

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

{
  "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 - モデルコンテキストプロトコル

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested