Yfinance Trader

🚀 YFinance取引員MCPツール

このツールは、yfinanceライブラリを使用して、株式市場のデータと取引機能を提供するモデルコンテキストプロトコル（Model Context Protocol）ツールです。

🚀 クイックスタート

YFinance取引員MCPツールを使用することで、リアルタイムの株価情報や会社の財務指標、過去の価格データなどを取得できます。また、株式コードの検索やインサイダー取引の追跡も可能です。

✨ 主な機能

• リアルタイムの株価情報
• 会社情報と財務指標
• 過去の価格データ
• 株式コード検索機能
• インサイダー取引の追跡

📦 インストール

1. Python 3.10以上がインストールされていることを確認してください。
2. 依存関係をインストールします。

pip install -r requirements.txt
# または pyproject.toml を使用する場合
pip install .

📚 ドキュメント

Cursorとの統合

1. Cursorで、設定 > MCPに移動します。
2. 「+ 新しいMCPサーバーを追加」をクリックします。
3. フォームに以下の情報を入力します。
   • 名前： "yfinance-trader"（または任意の名前）
   • コマンド： python3 /path/to/your/yfinance-trader/main.py

サンプルコマンド：

python3 /Users/username/projects/yfinance-trader/main.py

（パスは実際のmain.pyのパスに置き換えてください） 4. 「追加」をクリックし、必要に応じてCursorを再起動します。

利用可能なツール

1. get_stock_quote

リアルタイムの株価情報を取得します。

{
    "symbol": "AAPL",
    "price": 150.25,
    "change": 2.5,
    "changePercent": 1.67,
    "volume": 1234567,
    "timestamp": "2024-03-20T10:30:00"
}

2. get_company_overview

会社情報と主要な指標を取得します。

{
    "name": "Apple Inc.",
    "sector": "Technology",
    "industry": "Consumer Electronics",
    "marketCap": 2500000000000,
    "peRatio": 25.4,
    "forwardPE": 24.2,
    "dividendYield": 0.65,
    "52WeekHigh": 182.94,
    "52WeekLow": 124.17
}

3. get_time_series_daily

過去の日次価格データを取得します。

{
    "symbol": "AAPL",
    "timeSeriesDaily": [
        {
            "date": "2024-03-20T00:00:00",
            "open": 150.25,
            "high": 152.30,
            "low": 149.80,
            "close": 150.00
        }
    ]
}

4. get_stock_search

キーワードに基づいて株式を検索します。

{
    "search_term": "Apple",
    "results": [
        {
            "symbol": "AAPL",
            "name": "Apple Inc.",
            "exchange": "NASDAQ"
        },
        {
            "symbol": "APPL",
            "name": "Applied Materials Inc.",
            "exchange": "NASDAQ"
        }
    ]
}

5. get_insider_trading

インサイダー取引の情報を取得します。

{
    "symbol": "AAPL",
    "insider_trading": [
        {
            "name": "Tim Cook",
            "position": "CEO",
            "transaction_type": "Buy",
            "shares": 1000,
            "price": 150.25,
            "date": "2024-03-15"
        }
    ]
}

エラー処理

{
    "error": {
        "code": 404,
        "message": "股票代码不存在或无法找到数据"
    }
}

トラブルシューティング

1. ネットワーク接続を確認し、インターネットにアクセスできることを確認してください。
2. すべての依存関係が正しくインストールされていることを確認してください。
3. サービスを再起動してみてください。
4. 詳細な情報を取得するには、ログファイルを確認してください。

📄 ライセンス

MITライセンス