tsrs

tsrs-mcp-server 是一个基于 Rust 的 MCP 服务器，封装了 TuShare 的数据接口，提供多种股票市场数据查询工具。运行后，客户端可以通过 MCP 规范的接口调用这些工具，并获取结构化的数据。该服务器通过 Poem MCP Server 框架实现，具备标准化的查询能力和稳定的流式/批量数据返回。你可以使用提供的端点来获取日线、分钟数据、资金流向等不同维度的数据，工具列表包括 limit_step、ths_hot、kpl_list、kpl_concept、kpl_concept_cons、limit_cpt_list、moneyflow_ths、moneyflow_cnt_ths、stk_mins 等，每个工具都对应一定的必填参数和返回字段。为了使用这些工具，确保 TuShare 的 API Token 已正确设置，服务器启动后可通过指定的 endpoint 调用相应的工具名称及参数，服务器也支持 Streamable HTTP 模式，便于与其他服务集成。

安装步骤（推荐使用 Docker 运行）:

1. 先确保你的环境中已安装 Docker。

2. 将 README 中的 TuShare Token 设置为有效 token（见环境变量配置）。

3. 获取并运行镜像（以本项目镜像名为示例，实际镜像名请以你构建或拉取的镜像为准）：

   docker pull hanxuanliang-tsrs-mcp-server:latest

4. 启动服务器（将环境变量替换为你的实际值）：

   docker run -e TUSHARE_TOKEN=your_token_here -i hanxuanliang-tsrs-mcp-server:latest

若你选择自行构建本地可执行文件：

1. 需要先安装 Rust 和 Cargo。

2. 克隆仓库并进入目录。

3. 构建 release 版本：

   cargo build --release

4. 运行编译产物（替换为实际二进制路径）：

   ./target/release/tsrs-mcp-server stdio

说明：服务器默认提供 stdio 模式，若需要 Stream 模式，请参考服务器文档设定相应的 HTTP 端点与配置。确保在运行前设置好 TuShare Token（TUSHARE_TOKEN）。

常见问题与提示:

• 确保 TuShare Token 在环境变量中正确设置，且 Token 未过期。
• 各工具的必填参数如 trade_date、start_date、end_date 等需按工具文档传入，时间格式通常为 YYYYMMDD。
• 如果遇到连接或速率限制，请检查 TuShare API 的权限设置和 Token 配额。
• 使用 Docker 运行时，若遇端口或卷映射问题，请根据你的环境调整 docker run 的参数。
• 对于本 MCP 服务器，输出数据为 MCP 规范的结构，便于在后续链式数据处理中使用。