Tushare MCP Server

🚀 Tushare MCP Server

このModel Context Protocol (MCP)サーバーは、Tushare APIを通じてAIアシスタントに中国株式市場データへのアクセスを提供します。

✨ 主な機能

• 主要な市場データAPI - 基本的な株式情報と価格データ
• 日次、週次、月次の価格 - 過去の株価データ
• 完全なMCPプロトコルサポート - Claude Desktopや他のMCPクライアントと互換性があります
• 専用のエラーハンドリング - 堅牢なAPIエラー管理
• 型安全性 - すべてのパラメータに対する完全なPydantic検証

🚀 クイックスタート

インストール

オプション1: ソースからインストール

git clone <repository-url>
cd tushare-mcp-server
pip install -r requirements.txt
pip install -e .

オプション2: 直接Pythonで実行

# インストールせずにクローンして実行
git clone <repository-url>
cd tushare-mcp-server
pip install -r requirements.txt

設定

1. Tushare ProからTushareトークンを取得します。

2. 環境変数を設定します:

   export TUSHARE_TOKEN="your_tushare_api_token_here"
   

3. または.envファイルを作成します:

   cp .env.example .env
   # .envを編集してTUSHARE_TOKENを追加
   

基本的な使用法

コマンドライン

# MCPサーバーを起動
TUSHARE_TOKEN=your_token python -m tushare_mcp_server.main

# デバッグモードで起動
DEBUG=true TUSHARE_TOKEN=your_token python -m tushare_mcp_server.main

Claude Desktopとの統合

Claude Desktopの設定に以下の構成を追加します:

{
  "mcpServers": {
    "tushare": {
      "command": "python",
      "args": ["-m", "tushare_mcp_server.main"],
      "env": {
        "TUSHARE_TOKEN": "your_tushare_api_token_here"
      }
    }
  }
}

💻 使用例

基本的な使用法

例1: 基本的な株式情報の取得

ユーザークエリー: "Ping An Bank (000001.SZ)について教えて"

Claudeが使用するツール: stock_basic

パラメータ:

{
  "ts_code": "000001.SZ"
}

返り値: 会社名、地域、業界、上場日など

例2: 日次株価の取得

ユーザークエリー: "2024年1月の000001.SZの日次価格を表示して"

Claudeが使用するツール: daily

パラメータ:

{
  "ts_code": "000001.SZ",
  "start_date": "20240101",
  "end_date": "20240131"
}

返り値: 各取引日の始値、高値、安値、終値、出来高、取引金額

例3: 週次株式データの取得

ユーザークエリー: "000001.SZの週次データを表示して"

Claudeが使用するツール: weekly

パラメータ:

{
  "ts_code": "000001.SZ",
  "start_date": "20240101",
  "end_date": "20240131"
}

返り値: 週次の始値、高値、安値、終値と出来高

例4: 月次株式データの取得

ユーザークエリー: "000001.SZの月次データを表示して"

Claudeが使用するツール: monthly

パラメータ:

{
  "ts_code": "000001.SZ",
  "start_date": "20240101",
  "end_date": "20241231"
}

返り値: 月次の始値、高値、安値、終値と出来高

🔧 利用可能なツール

株式基本情報

• stock_basic - 基本的な株式および会社情報

市場データ

• daily - 日次株価 (始値、高値、安値、終値、出来高、取引金額)
• weekly - 週次株式データ (Tushareポイント2000以上が必要)
• monthly - 月次株式データ (Tushareポイント2000以上が必要)

📊 株式コードの形式

株式コードには取引所の接尾辞を含める必要があります:

• .SZ - 深セン証券取引所 (例: 000001.SZ)
• .SH - 上海証券取引所 (例: 600000.SH)
• .BJ - 北京証券取引所 (例: 830799.BJ)

📅 日付の形式

すべての日付はYYYYMMDD形式を使用します:

• 20240101 - 2024年1月1日
• 20231231 - 2023年12月31日

⚙️ 設定オプション

環境変数

• TUSHARE_TOKEN - あなたのTushare APIトークン (必須)
• DEBUG - デバッグログを有効にする (オプション、デフォルト: false)
• HOST - サーバーのホスト (オプション、デフォルト: 0.0.0.0)
• PORT - サーバーのポート (オプション、デフォルト: 8000)

.envファイルの例

TUSHARE_TOKEN=your_token_here
DEBUG=false
HOST=0.0.0.0
PORT=8000

🧪 テスト

基本機能テスト

# パッケージのインポートをテスト
python -c "from tushare_mcp_server.main import main; print('✅ Package loads correctly')"

# デモを実行
python demo_simple.py

# サーバーを起動
TUSHARE_TOKEN=your_token python -m tushare_mcp_server.main

📚 ドキュメント

APIドキュメントは、実装されたエンドポイントについてapi/ディレクトリにあります:

• 認証と使用方法 (api/authentication-usage.md)
• 株式基本情報 (api/stock_basic.md)
• 市場データ (api/data_daily.md, api/data_weekly.md, api/data_monthly.md)

📄 ライセンス

このプロジェクトはMITライセンスの下でライセンスされています - 詳細についてはLICENSEファイルを参照してください。

🙏 謝辞

• 金融データAPIを提供してくれたTushare Pro
• MCP仕様を提供してくれたModel Context Protocol
• 優れたツールとライブラリを提供してくれたオープンソースコミュニティ

良い取引を！🚀