tushare_MCP

🚀 Tushare MCP 服务器

Tushare MCP 服务器是基于 Model Context Protocol (MCP) 的智能股票数据助手，能为用户提供便捷、高效的股票数据查询与分析服务。

🚀 快速开始

环境要求

• 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

2. 启动服务

python server.py

3. 在Claude中安装

mcp install server.py

✨ 主要特性

1. 股票基础信息查询

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

2. 智能股票搜索

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

3. 财务报表分析

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

4. 安全的Token管理

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

💻 使用示例

1. 投资研究

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

2. 财务分析

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

3. 行业分析

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

4. 报表查询

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

🔧 技术细节

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

🔑 首次配置

1. 获取Token

   • 访问 Tushare Token页面。
   • 登录获取API Token。

2. 配置Token

   对Claude说：请帮我配置Tushare token
   

3. 验证配置

   对Claude说：请验证Tushare token是否有效
   

🤝 贡献指南

欢迎提交Issue和Pull Request！

📄 许可证

本项目采用 MIT 许可证，详见 LICENSE 文件。