🚀 tsrs-mcp-server

这是一个基于 模型上下文协议 (MCP) 的TuShare数据服务器，它提供了一系列股票市场数据查询接口，能帮助用户便捷地获取所需的股票市场数据。

🚀 快速开始

在使用本项目前，你需要进行环境配置和构建操作。首先，要设置TuShare的API token，然后进行项目的构建。

环境配置

在运行之前，需要设置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-<tag>-aarch64-apple-darwin.tar.gz。 运行方式如下图配置(仅展示在 chatwise 的配置):

✨ 主要特性

项目提供了以下 MCP 工具：

📚 详细文档

项目简介

本项目是一个用 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, 本项目的模版实现将变得异常机械化。

• TuShare API
• poem-mcpserver