Tushare_MCP

Tushare_MCP

基于 Model Context Protocol (MCP) 的智能股票数据助手

该项目基于 Tushare 的金融数据接口进行开发，支持的能力包括：

1、工具调用，比方说股票的行情数据、更深度的财务数据以及指数数据等。

2、提供安全的 Tushare Token 配置与状态检查机制。

3、通过 FastAPI 封装，提供标准化的 HTTP API 接口，方便与其他应用集成。

👉使用 cherry studio 快速体验教程

20250515 更新

新增 hotlist.py，一个强大的工具模块，专注于热点榜单追踪与深度题材挖掘！

通过 hotlist.py，您可以轻松实现：

• 单一工具查询： 快速获取特定日期、特定市场（如开盘啦、同花顺、东方财富）的概念板块列表、涨停跌停股票列表、或 App 实时热榜数据。
• 交集分析能力： 组合不同平台的概念/题材及其成分股数据，高效定位那些被多个权威源共同认可的潜力板块或个股。
• 异动数据洞察： 结合概念板块的成分股与涨停、跌停、热榜等数据，精准筛选出在特定题材内表现强势或出现关键信号的股票。
• 趋势研判辅助： 查询某一概念板块在一段时间内的行情数据，或追踪某一股票/板块在历史数据中上榜的频率，辅助判断其热度持续性与资金关注度变化。

您可以向 AI 助手提出以下类型的问题（包括但不限于）：

• “今天同花顺有哪些热门概念板块？”
• “昨天有哪些股票涨停了？”
• “哪些股票同时是开盘啦的A题材和同花顺的B概念的成分股？”
• “在'人工智能'这个同花顺概念里，今天有哪些成分股涨停了？”
• “查询'新能源车'板块指数过去一个月的每日涨跌幅。”
• “帮我统计一下某只股票在过去一周内登上同花顺热股榜的次数。”

✨ 已支持能力

• 全面的股票数据查询：
  • 提供股票基本信息、实时行情（日线、指标）、历史股价变动查询。
  • 支持通过股票代码或名称进行智能搜索。

• 深度财务数据分析：
  • 获取上市公司详细财务报表，包括利润表、资产负债表、现金流量表。
  • 查询关键财务指标数据。

• 指数与市场数据覆盖：
  • 支持主流指数的基本信息查询、成分股获取及全球指数行情。

• 股东及公司基本面信息：
  • 查询股东户数、十大股东信息、每日股本市值以及股权质押明细。

• 热门榜单与题材数据 (由 hotlist.py 提供)：
  • 开盘啦 (KPL) 数据:
    • 概念题材列表查询 (可按日期、代码、名称筛选)。
    • 概念题材成分股查询 (可按日期、题材代码、股票代码筛选)。
    • 涨停、跌停、炸板、自然涨停、竞价等榜单数据获取。
  • 每日涨跌停统计:
    • 获取每日股票涨停(U)、跌停(D)和炸板(Z)的详细统计数据。
  • 同花顺 (THS) 数据:
    • 板块指数列表查询 (概念、行业、地域等)。
    • 概念板块成分股查询。
    • 板块指数每日行情数据。
    • 同花顺App热榜数据 (热股、概念板块、ETF等)。
  • 东方财富 (Eastmoney) 数据:
    • 每日概念板块数据查询 (可按代码、名称、日期范围筛选)。
    • 概念板块每日成分股查询。

❌ 未支持能力

• 公告、研报等资讯类数据
• 更细颗粒度的技术面数据 (分钟线、Tick行情)
• 宏观经济数据、期货、期权等非股票类数据

🚀 快速开始

环境要求

• Python 3.8+
• Tushare 账号和 API Token (获取地址: Tushare Pro Token 申请页面，请自行注册)

安装步骤

1. 克隆仓库：
   git clone <你的 GitHub 仓库 HTTPS 或 SSH链接> cd <你的项目目录名>
2. 创建并激活虚拟环境 (推荐)：
   python -m venv venv source venv/bin/activate # Linux/macOS # venv/Scripts/activate # Windows
3. 安装依赖：
   pip install -r requirements.txt

配置 Tushare Token

本项目需要 Tushare API Token 才能正常工作。你有以下几种方式配置 Token：

1. 通过 .env 文件 (推荐，安全)：
   • 在项目根目录下创建一个名为 .env 的文件 (此文件已被 .gitignore 忽略，不会提交到版本库)。
   • 在 .env 文件中添加以下内容，并将 <你的TUSHARE_TOKEN> 替换为你的真实 Token：
     TUSHARE_TOKEN=<你的TUSHARE_TOKEN>
2. 通过环境变量： 在运行 server.py 之前，设置名为 TUSHARE_TOKEN 的环境变量。
   export TUSHARE_TOKEN="<你的TUSHARE_TOKEN>" # Linux/macOS # set TUSHARE_TOKEN="<你的TUSHARE_TOKEN>" # Windows (cmd) # $env:TUSHARE_TOKEN="<你的TUSHARE_TOKEN>" # Windows (PowerShell)

启动服务

在 AI IDE 软件中（如 Cursor 或 Trae） 的 MCP 服务中添加对应的 Servers

📄 开源协议

MIT License - 详见 LICENSE 文件

本地环境说明

Python 环境是由操作系统或外部工具（比如 Homebrew）管理的。为了保护系统级的 Python 安装，直接使用 pip3 install 来安装包到全局环境通常是不被允许的。需要通过激活虚拟环境（前提是创建虚拟环境）来完成