Tushare MCP

🚀 Tushare MCP サーバー

Model Context Protocol (MCP) をベースにした、スマートな株式データアシスタントです。

🚀 クイックスタート

Tushare MCPサーバーは、Model Context Protocol (MCP) をベースにしたスマートな株式データアシスタントです。このサーバーを使うことで、株式の基礎情報の照会や、財務報表の分析などの機能を利用できます。

✨ 主な機能

1. 株式基礎情報照会

• 株式コード（例：000001.SZ）による正確な照会に対応
• 株式名（例：平安銀行）による曖昧照会に対応
• 返される情報には以下が含まれます：
  • 株式コードと名称
  • 所属業界と地域
  • 上場日
  • 市場タイプ
  • 取引状態

2. スマート株式検索

• 曖昧なキーワード検索に対応
• 株式コードと名称の両方を同時にマッチング
• 業界キーワード検索（例：「新エネルギー」、「テクノロジー」）に対応
• 最も一致度の高い株式リストを返す

3. 財務報表分析

• 上場企業の損益計算書データの照会に対応
• 柔軟な期間照会（年報、四半期報告、半年報告）
• 複数の報表タイプに対応（連結決算書、親会社決算書など）
• 主な指標が一目でわかります：
  • 一株当たり利益
  • 営業収入とコスト
  • 期間費用
  • 利益指標
• 過去のデータの比較分析に対応

4. 安全なトークン管理

• 対話型トークン設定フロー
• ローカルの安全な保存（暗号化保存）
• トークンの有効性の自動検証
• 定期的なトークン状態のチェック

🎯 使用シナリオ

1. 投資研究

「すべての新エネルギー関連の株式を探してください」
「ビヤディの基本情報を照会してください」
「平安銀行の2023年の損益計算書を取得してください」

2. 財務分析

「騰訊ホールディングスの最新の連結決算書を見てください」
「アリババの過去3年間の利益変化を比較してください」
「小米グループの四半期利益傾向を分析してください」

3. 業界分析

「すべての医薬品業界の株式をリストアップしてください」
「深セン地域のテクノロジー企業を探してください」

4. 報表照会

「平安銀行の2023年第1四半期の損益計算書を照会してください」
「ビヤディの親会社決算書を取得してください」
「茅台の過去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 Tokenページにアクセス
• ログインしてAPIトークンを取得

2. トークンの設定

Claudeに「Tushareトークンを設定してください」と言う

3. 設定の検証

Claudeに「Tushareトークンが有効かどうかを検証してください」と言う

🤝 コントリビューションガイド

IssueとPull Requestの提出を歓迎します！

📄 ライセンス

MITライセンス - 詳細は LICENSE ファイルを参照してください。