Claude デスクトップ用 YFinance Trader MCP ツール

Claude Desktop 向けに特別に調整された、yfinance ライブラリを使用して株式市場データと取引機能を提供する MCP (Model Context Protocol) ツールです。

クレジット：このプロジェクトは、Luigi Ajah氏によるmcp-stocks （カーソルの類似実装）に触発されました。この改良版では、オリジナルのコンセプトをClaude Desktopで動作するように修正しています。

チュートリアル

このツールの設定と使用に関する詳細なガイドについては、Mediumチュートリアルをご覧ください。チュートリアル: Claude DesktopとYFinance Trader MCPツールを使用してリアルタイムの株式市場データにアクセスする

Related MCP server: Finance MCP Server

特徴

リアルタイム株価
企業情報と財務指標
過去の価格データ
シンボル検索機能
アナリストの推奨事項
インサイダー取引追跡

設定

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

pip install -r requirements.txt

Claude Desktopとの統合

次の内容を MCP 構成に追加して、Claude Desktop で MCP 設定を構成します。

{
  "mcpServers": {
    "yfinance-trader": {
      "command": "py",
      "args": ["-3.13", "path/to/your/main.py"]
    }
  }
}

パスをmain.pyファイルへのフルパスに置き換えます。
必要に応じてClaude Desktopを再起動してください

利用可能なツール

1. get_stock_quote

リアルタイムの株価情報を入手:

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

2. 会社概要を取得する

企業情報と主要指標を取得します。

{
    "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": 151.75,
            "volume": 12345678
        }
        // ... more data points
    ]
}

4. 検索シンボル

株式およびその他の証券を検索:

{
    "results": [
        {
            "symbol": "AAPL",
            "name": "Apple Inc.",
            "type": "EQUITY",
            "exchange": "NASDAQ"
        }
        // ... more results
    ]
}

5. get_recommendations

株式に関するアナリストの推奨を取得します。

{
    "symbol": "AAPL",
    "recommendations": [
        {
            "period": "2024-03-15T00:00:00",
            "strongBuy": 15,
            "buy": 20,
            "hold": 8,
            "sell": 2,
            "strongSell": 0
        }
        // ... more periods
    ]
}

6. get_insider_transactions

インサイダー取引情報を入手する:

{
    "symbol": "AAPL",
    "transactions": [
        {
            "date": "2024-03-15T00:00:00",
            "insider": "John Doe",
            "position": "Director",
            "transactionType": "Buy",
            "shares": 1000,
            "value": 150250.00,
            "url": "https://finance.yahoo.com/...",
            "text": "Purchase of 1000 shares",
            "startDate": "2024-03-15",
            "ownership": "Direct"
        }
        // ... more transactions
    ]
}

サンプルクエリ

Claude Desktop に次のような質問をすることができます:

「AAPL の現在の株価と日々の変化はいくらですか？」
「マイクロソフト（MSFT）の会社概要を教えていただけますか？」
「過去 3 か月間の Tesla (TSLA) の過去の価格データを表示してください。」
「『NVDA』に関連する株式を検索します。」
「Amazon (AMZN) に対するアナリストの推奨事項は何ですか?」
「最近、Google (GOOGL) にインサイダー取引はありましたか？」

暗号通貨サポート

特別なティッカー形式を使用すると、限定された暗号通貨データが利用可能になります。

ビットコインのBTC-USD
イーサリアムのETH-USD
ドージコインのDOGE-USD

エラー処理

すべてのツールには適切なエラー処理が組み込まれており、何か問題が発生した場合にはエラーメッセージを返します。

{
    "error": "Failed to fetch quote for INVALID_SYMBOL"
}

トラブルシューティング

Claude Desktop で MCP サーバーが動作していない場合:

サーバーが実行中であることを確認してください。スクリプトを開始すると出力が表示されます。
設定のパスが正しく絶対パスであることを確認してください
Python 3.10+がシステムPATHにあることを確認してください
すべての依存関係がインストールされていることを確認する
Claude Desktopを再起動してみてください
ログにエラーメッセージがないか確認する

オリジナルのmcp-stocksプロジェクトとの違い

FastAPIの代わりにMCPライブラリを直接使用します
カーソルの代わりにClaude Desktopに適応
エラー処理と応答形式の変更
更新された構成アプローチ

ライセンス

MITライセンス

YFinance Trader MCP Tool