Tushare MCP Server

<div align="center">

基于模型上下文协议（MCP）的智能股票数据助手

</div>

🚀 核心功能

1. 基本股票信息查询

• 支持通过股票代码进行精确查询（例如：000001 SZ）
• 支持通过股票名称进行模糊搜索（如：平安银行）
• 返回的信息包括：
  • 股票代码和名称
  • 行业和地区
  • 发布日期
  • 市场类型
  • 交易状态

2. 智能股票搜索

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

3. 财务报表分析

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

4. 安全令牌管理

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

🎯 使用场景

1. 投资研究

   "帮我查找所有新能源相关的股票"
   "查询比亚迪的基本信息"
   "获取平安银行2023年的利润表"
   

2. 财务分析

   "查看腾讯控股最新一期合并报表"
   "对比阿里巴巴近三年的利润变化"
   "分析小米集团的季度利润趋势"
   

3. 行业分析

   "列出所有医药行业的股票"
   "查找深圳地区的科技公司"
   

4. 报表查询

   "查询平安银行2023年第一季度的利润表"
   "获取比亚迪的母公司报表"
   "查看茅台近5年的年度利润表"
   

🛠️ 技术特性

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

📦 安装指南

环境要求

• Python 3.8+
• Tushare Pro账户和API令牌

快速开始

1. 安装包

git clone https://github.com/zhewenzhang/tushare_MCP.git
cd tushare_MCP
pip install -r requirements.txt

2. 启动服务

python server.py

3. 在Claude中安装

mcp install server.py

🔑 首次配置

1. 获取令牌

   • 访问Tushare令牌页面
   • 登录以获取API令牌

2. 配置令牌

   对Claude说：请帮我配置Tushare token
   

3. 认证配置

   对Claude说：请检查token状态
   

📚 API参考

工具函数

1. 股票查询

get_stock_basic_info(ts_code="", name="")
# 示例：get_stock_basic_info(ts_code="000001.SZ")

2. 股票搜索

search_stocks(keyword="")
# 示例：search_stocks(keyword="新能源")

3. 损益表查询

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")

4. 令牌管理

setup_tushare_token(token="")
check_token_status()

🔒 数据安全

• 令牌存储：位于用户的家目录.tushare_mcp/.env
• 环境变量：使用Python dongenv进行安全管理
• 数据传输：HTTPS加密

🤝 贡献指南

欢迎提交Issue和Pull Requests！

📄 开源许可

MIT许可 - 查看详细内容LICENSE文档