MCP Server for Shioaji

MCP Server for Shioaji

site icon
2025.03.31 5
Python金融数据服务股票数据自动化交易金融服务
mcp-server-shioaji 是一个基于 Model Context Protocol (MCP) 的服务器,为 AI 助手提供访问台湾金融市场 Shioaji 交易 API 的能力。该服务器通过 MCP 协议将 Shioaji API 功能暴露为工具,供 AI 模型使用。核心功能包括获取当前股票价格、获取历史数据、列出可用股票等。适用于需要访问台湾金融市场数据的 AI 助手和自动化交易系统。
View on GitHub

Overview

基本能力

产品定位

mcp-server-shioaji 是一个金融数据服务,专门为 AI 助手提供台湾金融市场的股票数据访问能力。

核心功能

  • 获取当前股票价格
  • 获取历史 K 线数据
  • 扫描并排名股票

适用场景

  • AI 助手需要实时股票数据
  • 自动化交易系统需要历史数据进行分析
  • 金融数据分析工具需要股票排名信息

工具列表

  1. get_stock_price:获取指定股票代码的当前价格信息,包括开盘价、最高价、最低价、收盘价、成交量等。
  2. get_kbars:获取指定股票在特定日期范围内的 K 线数据。
  3. scan_stocks:根据不同的排名标准扫描股票,如成交量排名、交易金额排名等。

常见问题解答

  • 如何配置 API 密钥? 可以通过环境变量或 .env 文件配置 Shioaji API 密钥。
  • 服务器默认运行在哪个端口? 服务器默认运行在 http://0.0.0.0:8000

使用教程

使用依赖

  • Python 3.10 或更高版本
  • uv(快速的 Python 包管理器)

安装 uv:

uv sync

安装教程

  1. 克隆项目仓库
  2. 配置 API 密钥(通过环境变量或 .env 文件)
  3. 启动服务器:
uv run mcp-server-shioaji

调试方式

启动服务器后,可以通过发送 MCP 协议请求来测试工具功能。例如:

curl -X POST http://0.0.0.0:8000 -d '{"tool": "get_stock_price", "params": {"symbols": "TW.2330,TW.2317"}}'

许可证

该项目遵循 MIT 开源许可条款。