tsrs-mcp-server

此项目基于 模型上下文协议（MCP），提供了一系列用于查询股市数据的接口。

项目介绍

该项目是一个用 Rust 实现的 MCP 服务器，封装了 TuShare API 接口，并提供了多个股市数据查询工具。项目使用的主要技术包括：

• Rust
• 模型上下文协议（MCP）
• Poem MCP 服务器
• TuShare API
• 过程宏

特性

该项目提供了以下 MCP 工具：

工具名称	功能描述	主要参数	返回数据
Limit_step	获取每日连续交易日上涨的股票数量	trade_date, start_date, end_date, nums	股票代码、名称、交易日期及连续交易日数
Ths_hot	获取同花顺应用热门列表数据	trade_date	股票信息、排名、热度、概念等
Kpl_list	获取涨停和跌停数据	tag, start_date, end_date	涨停和跌停详细信息、交易数据等
Kpl_concept	获取开盘概念主题列表	trade_date	主题代码、名称、涨停数量等
Kpl_concept_coms	获取开盘概念主题构成股票的详细信息	trade_date, ts_comde	构成股票
Limit_cpt_dast	获取每日涨停数量最多的概念板块	trade_date, start_date, end_date	板块代码、名称、连续数据等
MoneyFlow_ths	获取同花顺个股资金流向详细数据	ts_comde, trade_date, start_date, end_date
Moneywflow_cnt_ths	获取同花顺概念板块每日资金流向数据	trade_date, start_date, end_date	板块资金流向数据
Stk_mins	获取A股分钟数据	ts_comde, freq, start_date, end_date	分钟级交易数据

项目结构

项目包含以下主要组件：

• ts-derive 提供 TuShare API 的过程宏实现
• ts-model 包含数据模型
• src 主程序实现

环境配置

运行前需要设置 TuShare API 的 token：

• 复制 .env.example 为 .env
• 在 .env 文件中设置你的 TuShare token：

TUSHARE_TOKEN=your_token_here

构建

前提条件：安装 Rust 和 Cargo。

cargo build --release

./target/release/tsrs-mcp-server

运行

可以在发布版中找到对应平台的编译产物，例如 tsrs-mcp-server-<tag>-aarch64-apple-darwin.tar.gz。

服务器支持两种操作模式：

1. 标准输入输出模式（默认）：直接下载发布版产品。执行：./tsrs-mcp-server stdio
2. 流模式：提供可流式传输的 HTTP 模式。端点：http://127.0.0.1:8999

操作模式配置如下图所示（仅在 chatwise 配置中显示）：

致谢

感谢以下项目和库，特别是 poem-mcpserver 对 MCP 编写的强大便利支持，没有这些，本项目不会如此简单地实现。同时感谢 TuShare API 提供的数据接口。最后，感谢 rust 及其 过程宏，使得本项目的模板实现异常机械化。

• TuShare API
• poem-mcpserver

许可证

本项目采用 MIT 许可证。详情见 LICENSE 文档。