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