Yahoo Finance MCP Server

Yahoo Finance MCP Server

Yahoo Finance の包括的な金融データを提供する Model Context Protocol（MCP）サーバーです。株価の過去データ、企業情報、財務諸表、オプションデータ、市場ニュースなど、株式に関する詳細情報を取得できます。

デモ

MCP ツール

このサーバーは、Model Context Protocol を通じて以下のツールを公開します。

株式情報

ツール	説明
get_historical_stock_prices	期間と間隔を指定して、株式の過去の OHLCV データを取得します
get_stock_info	価格、指標、企業情報を含む包括的な株式データを取得します
get_yahoo_finance_news	株式に関する最新ニュース記事を取得します
get_stock_actions	株式の配当と株式分割の履歴を取得します

財務諸表

ツール	説明
get_financial_statement	損益計算書、貸借対照表、またはキャッシュフロー計算書を取得します（年次／四半期）
get_holder_info	大株主、機関投資家、投資信託、またはインサイダー取引を取得します

オプションデータ

ツール	説明
get_option_expiration_dates	利用可能なオプションの満期日を取得します
get_option_chain	指定した満期日とタイプ（コール／プット）のオプションチェーンを取得します

アナリスト情報

ツール	説明
get_recommendations	アナリストの推奨、または格上げ／格下げの履歴を取得します

実際の活用例

この MCP サーバーを使うと、Claude に次のような依頼ができます。

株式分析

• 価格分析：「過去6か月間の NOW の株価を、日次間隔で表示してください。」
• 財務健全性：「Intuit の四半期貸借対照表を取得してください。」
• 業績指標：「株式情報から Intuit の主要な財務指標を教えてください。」
• トレンド分析：「ServiceNow と Intuit の四半期損益計算書を比較してください。」
• キャッシュフロー分析：「ServiceNow の年次キャッシュフロー計算書を表示してください。」

市場調査

• ニュース分析：「Intuit に関する最新ニュース記事を取得してください。」
• 機関投資家の動向：「NOW 株の機関投資家を表示してください。」
• インサイダー取引：「ServiceNow の最近のインサイダー取引を教えてください。」
• オプション分析：「満期日を 2026-01-30 として、INTU のコールオプションのオプションチェーンを取得してください。」
• アナリストの評価：「過去3か月間の Intuit に対するアナリストの推奨を教えてください。」

投資調査

• 「Intuit の最新の四半期財務諸表を使って、財務健全性を包括的に分析してください。」
• 「Coca-Cola と PepsiCo の配当履歴と株式分割を比較してください。」
• 「過去1年間の ServiceNow の機関投資家保有比率の変化を分析してください。」
• 「30日後に満期を迎える Intuit 株のオプション市場の動向について、レポートを作成してください。」
• 「過去6か月間のテクノロジーセクターにおける最新のアナリストによる格上げと格下げを要約してください。」

要件

• Python 3.14.6 以降
• pyproject.toml に記載されている依存関係。以下を含みます。
  • mcp
  • yfinance
  • pandas
  • pydantic
  • その他のデータ処理用パッケージ

セットアップ

推奨：uvx で実行

ローカルの仮想環境を作成せずに、リポジトリからサーバーを直接実行します。

uvx --from git+https://github.com/Alex2Yang97/yahoo-finance-mcp yahoo-finance-mcp

ローカル開発

1. このリポジトリをクローンします。

   git clone https://github.com/Alex2Yang97/yahoo-finance-mcp.git
   cd yahoo-finance-mcp
   

2. 仮想環境を作成して有効化し、依存関係をインストールします。

   uv sync
   

使い方

クイックスタート

パッケージ化されたエントリーポイントを次のように実行します。

uvx --from git+https://github.com/Alex2Yang97/yahoo-finance-mcp yahoo-finance-mcp

このチェックアウトでローカルの変更を使う場合は、次を実行します。

uvx --from . yahoo-finance-mcp

開発モード

ローカルクローン内で作業していて、ソースツリーを直接実行する場合は、次を実行します。

uv run server.py

Claude for Desktop との統合

このサーバーを Claude for Desktop と統合するには：

1. Claude for Desktop をローカルマシンにインストールします。

2. VS Code をローカルマシンにインストールします。次に、以下のコマンドを実行して claude_desktop_config.json ファイルを開きます。

   • MacOS：code ~/Library/Application\ Support/Claude/claude_desktop_config.json
   • Windows：code $env:AppData\Claude\claude_desktop_config.json

3. 以下にある Claude for Desktop の設定ファイルを編集します。

   • macOS：

     {
       "mcpServers": {
         "yfinance": {
           "command": "uvx",
           "args": [
             "--from",
             "git+https://github.com/Alex2Yang97/yahoo-finance-mcp",
             "yahoo-finance-mcp"
           ]
         }
       }
     }
     

   • Windows：

     {
       "mcpServers": {
         "yfinance": {
           "command": "uvx",
           "args": [
             "--from",
             "git+https://github.com/Alex2Yang97/yahoo-finance-mcp",
             "yahoo-finance-mcp"
           ]
         }
       }
     }
     

   • 注：command フィールドには、uv 実行ファイルのフルパスを指定する必要がある場合があります。MacOS/Linux では which uv、Windows では where uv を実行すると確認できます。

4. Claude for Desktop を再起動します。

ライセンス

MIT