🚀 Shioaji 的 MCP 服务器
本服务器实现了模型上下文协议（MCP），能让 AI 助手访问台湾金融市场 Shioaji 交易 API，为金融数据获取和交易操作提供便利。
🚀 快速开始
安装
先决条件
- 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 协议实现了对 Shioaji API 功能的支持，使 AI 模型能够：
- 获取当前股票价格
- 获取历史数据
- 列出可用的股票
- 以及其他更多功能...
💻 使用示例
基础用法
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"
}
}