MCP Server Shioaji

🚀 Shioaji 的 MCP 服務器

本項目是一個實現模型上下文協議（MCP）的服務器，它能讓 AI 助手訪問臺灣金融市場 Shioaji 交易 API，為金融數據獲取和交易操作提供便利。

🚀 快速開始

該服務器藉助 MCP 協議支持 Shioaji API 功能，讓 AI 模型可以：

• 獲取當前股票價格
• 獲取歷史數據
• 列出可用的股票
• 以及其他更多功能...

📦 安裝指南

先決條件

• Python 3.10 或更高版本
• uv（快速 Python 包管理器）

使用 uv

uv sync

🔧 配置

在運行服務器之前，需要配置 Shioaji API 憑證，有以下兩種方法：

環境變量

設置以下環境變量：

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"
  }
}