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 文件。