Skip to main content
Glama
Sign In

Tushare MCP Server

by zhewenzhang
Verified
GitHub
Python
MIT License
RedditDiscord
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

  • Used for secure storage and management of Tushare API tokens in the user's home directory.

  • Server implementation requires Python 3.8+ to run the MCP service for Tushare data querying capabilities.

Tushare MCP Server

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

🚀 核心功能

1. 股票基础信息查询

  • 支持通过股票代码（如：000001.SZ）精确查询
  • 支持通过股票名称（如：平安银行）模糊查询
  • 返回信息包含：
    • 股票代码和名称
    • 所属行业和地区
    • 上市日期
    • 市场类型
    • 交易状态

2. 智能股票搜索

  • 支持模糊关键词搜索
  • 同时匹配股票代码和名称
  • 支持行业关键词搜索（如："新能源"、"科技"）
  • 返回匹配度最高的股票列表

3. 财务报表分析

  • 支持查询上市公司利润表数据
  • 灵活的时间范围查询（年报、季报、半年报）
  • 多种报表类型支持（合并报表、母公司报表等）
  • 主要指标一目了然：
    • 每股收益
    • 营业收入和成本
    • 期间费用
    • 利润指标
  • 支持历史数据对比分析

4. 安全的Token管理

  • 交互式Token配置流程
  • 本地安全存储（加密保存）
  • Token有效性自动验证
  • 定期Token状态检查

🎯 使用场景

  1. 投资研究
    "帮我查找所有新能源相关的股票" "查询比亚迪的基本信息" "获取平安银行2023年的利润表"
  2. 财务分析
    "查看腾讯控股最新一期合并报表" "对比阿里巴巴近三年的利润变化" "分析小米集团的季度利润趋势"
  3. 行业分析
    "列出所有医药行业的股票" "查找深圳地区的科技公司"
  4. 报表查询
    "查询平安银行2023年第一季度的利润表" "获取比亚迪的母公司报表" "查看茅台近5年的年度利润表"

🛠️ 技术特点

  • 基于MCP协议，支持与Claude等AI助手自然对话
  • 实时连接Tushare Pro数据源
  • 智能错误处理和提示
  • 支持并发请求处理
  • 数据缓存优化

📦 安装说明

环境要求

  • Python 3.8+
  • Tushare Pro账号和API Token

快速开始

  1. 安装包
git clone https://github.com/zhewenzhang/tushare_MCP.git cd tushare_MCP pip install -r requirements.txt
  1. 启动服务
python server.py
  1. 在Claude中安装
mcp install server.py

🔑 首次配置

  1. 获取Token
  2. 配置Token
    对Claude说：请帮我配置Tushare token
  3. 验证配置
    对Claude说：请检查token状态

📚 API参考

工具函数

  1. 股票查询
get_stock_basic_info(ts_code="", name="") # 示例：get_stock_basic_info(ts_code="000001.SZ")
  1. 股票搜索
search_stocks(keyword="") # 示例：search_stocks(keyword="新能源")
  1. 利润表查询
get_income_statement(ts_code="", start_date="", end_date="", report_type="1") # 示例：get_income_statement(ts_code="000001.SZ", start_date="20230101", end_date="20231231")
  1. Token管理
setup_tushare_token(token="") check_token_status()

🔒 数据安全

  • Token存储：用户主目录下的.tushare_mcp/.env
  • 环境变量：使用python-dotenv安全管理
  • 数据传输：HTTPS加密

🤝 贡献指南

欢迎提交Issue和Pull Request！

📄 开源协议

MIT License - 详见 LICENSE 文件

This server cannot be installed

-
security - not tested
A
license - permissive license
-
quality - not tested

A server based on Model Context Protocol that enables AI assistants to query and search for stock information using the Tushare API.

  1. 🚀 核心功能
    1. 1. 股票基础信息查询
    2. 2. 智能股票搜索
    3. 3. 财务报表分析
    4. 4. 安全的Token管理
  2. 🎯 使用场景
    1. 🛠️ 技术特点
      1. 📦 安装说明
        1. 环境要求
        2. 快速开始
      2. 🔑 首次配置
        1. 📚 API参考
          1. 工具函数
        2. 🔒 数据安全
          1. 🤝 贡献指南
            1. 📄 开源协议
              ID: po6agevqgd