Alex2Yang97/yahoo-finance-mcp

This is a Model Context Protocol (MCP) server that provides comprehensive financial data from Yahoo Finance. It allows you to retrieve detailed information about stocks, including historical prices, company information, financial statements, options data, and market news.

Yahoo Finance MCP Server

Model Context Protocol (MCP) の軽量サーバーで、公開されている Yahoo Finance API をラップし、LLM が駆動するエージェント（例：Claude）が豊富な金融データにアクセスできるようにします。このサーバーは、LLM が呼び出すことのできる型指定されたツールのコレクションを公開しており、以下の情報を取得できます：

カテゴリ	ツール（簡単な説明）
株式情報	`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` – アナリストの評価、格上げ・格下げ

AIにとっての重要性

このサーバーは、Claude for Desktop（または任意の MCP 対応モデル）から呼び出されるように設計されており、モデルが最新の市場データ、ニュース、所有構造情報を活用して推論を補強できます。これにより、モデルが自らウェブをスクレイピングする必要なく、金融リサーチアシスタント としての機能を備えた言語モデルに進化します。

実世界のプロンプト（README からの抜粋）

「過去6か月間、NOWの日次間隔の歴史的株価を表示して。」 → get_historical_stock_prices
「Intuitの四半期ごとの貸借対照表を取得して。」 → get_financial_statement
「Intuitの過去3か月間のアナリストの推薦は？」 → get_recommendations
「2026-01-30満期のINTUのコールオプションのチェーンを取得して。」 → get_option_chain

これらの例は、LLM が自然言語で質問をし、MCP サーバーがそれらを具体的な API 呼び出しに翻訳できる様子を示しています。

はじめ方

インストールせずに実行 – README では uvx を推奨しています：

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

ローカル開発 – リポジトリをクローンし、pyproject.toml に記載された依存関係を uv sync でインストール（Python ≥ 3.14.6、mcp、yfinance、pandas、pydantic など）した後、uv run server.py でサーバーを起動します。
Claude に接続 – 上記のコマンドを指す yfinance MCP エントリを claude_desktop_config.json に追加し、Claude を再起動します。

ライセンス

MIT – 使用、変更、再配布が自由です。

すべての詳細はリポジトリの README から直接引用されています。