Tushare_MCP

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

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

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

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

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

20250515 更新

支持基础的港股股票查询

删除多余的测试文件

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)
   

启动服务

python server.py

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

📄 开源协议

MIT License - 详见 LICENSE 文件

本地环境说明

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

python3 -m venv venv

source venv/bin/activate