🚀 tsrs-mcp-server
这是一个基于 模型上下文协议 (MCP) 的 TuShare 数据服务器，为用户提供了一系列股票市场数据查询接口，能帮助用户便捷地获取所需的股票市场信息。
🚀 快速开始
在使用本项目前，你需要进行环境配置和项目构建。
环境配置
在运行之前，需要设置 TuShare 的 API token：
- 复制
.env.example为.env - 在
.env文件中设置你的 TuShare token:
TUSHARE_TOKEN=your_token_here
构建
前提条件：安装 Rust 和 Cargo。
cargo build --release
./target/release/tsrs-mcp-server
运行
你可以在 release 中找到对应平台下的编译产物, 例如 tsrs-mcp-server-。
运行方式如下图配置(仅展示在 chatwise 的配置):
✨ 主要特性
项目提供了以下 MCP 工具：
| 工具名称 | 功能描述 | 主要参数 | 返回数据 |
|---|---|---|---|
| limit_step | 获取每天连板个数晋级的股票 | trade_date, start_date, end_date, nums | 股票代码、名称、交易日期、连板次数 |
| ths_hot | 获取同花顺 App 热榜数据 | trade_date | 股票信息、排名、热度、概念等 |
| kpl_list | 获取涨跌停板数据 | tag, start_date, end_date | 涨跌停详细信息、成交数据等 |
| kpl_concept | 获取开盘啦概念题材列表 | trade_date | 题材代码、名称、涨停数量等 |
| kpl_concept_cons | 获取开盘啦概念题材的成分股 | trade_date, ts_code | 题材成分股详细信息 |
| limit_cpt_list | 获取每天涨停股票最多的概念板块 | trade_date, start_date, end_date | 板块代码、名称、连板数据等 |
| moneyflow_ths | 获取同花顺个股资金流向数据 | ts_code, trade_date, start_date, end_date | 资金流向详细数据 |
| moneyflow_cnt_ths | 获取同花顺概念板块每日资金流向 | trade_date, start_date, end_date | 板块资金流向数据 |
| stk_mins | 获取 A 股分钟数据 | ts_code, freq, start_date, end_date | 分钟级别的交易数据 |
📚 详细文档
项目简介
本项目是一个用 Rust 实现的 MCP 服务器，封装了 TuShare 的 API 接口，提供了多个股票市场数据查询工具。项目主要使用以下技术：
- Rust
- 模型上下文协议 (MCP)
- Poem MCP 服务器
- TuShare API
- 过程宏 (Procedural Macros)
项目结构
项目包含以下主要组件：
ts-derive：提供用于 TuShare API 的过程宏实现ts-model：包含数据模型src：主程序实现
📄 许可证
本项目采用 MIT 许可证。详见 LICENSE 文件。
鸣谢
感谢以下项目和库, 尤其是 poem-mcpserver 对 MCP 编写的极大便捷性支持, 没有它, 本项目没有如此简便的实现方式。同时感谢 TuShare API 提供的数据接口。最后要感谢 rust, 没有 procedural macros, 本项目的模版实现将变得异常机械化。