Yahoo Finance MCPサーバー

👁 PyPI version
👁 Python
👁 CI
👁 License: MIT

Model Context Protocol (MCP)サーバーであり、AIアシスタントがyfinanceを通じてYahoo Financeのデータにアクセスできるようにします。株価情報、金融ニュース、セクターランキングの照会や、プロフェッショナルな財務チャートの生成をすべてAIチャットから行えます。

機能

• 株価データ — 企業情報、財務、評価指標、配当、取引データ

• 財務諸表 — 過去データを含む損益計算書および貸借対照表（EBIT、投下資本など）

• 金融ニュース — 各ティッカーの最新ニュース記事およびプレスリリース

• 検索 — Yahoo Finance全体から株式、ETF、ニュースを検索

• セクターランキング — セクター別のトップETF、投資信託、企業、成長リーダー、好調企業

• 価格履歴 — Markdownテーブルまたはプロフェッショナルなチャートとしての過去のOHLCVデータ

• チャート生成 — WebP画像として返されるローソク足、VWAP、出来高プロファイルチャート

Related MCP server: MCP Yahoo Finance

ツール

yfinance_get_ticker_info

企業情報、財務、取引指標、ガバナンスデータを含む包括的な株価データを取得します。

戻り値: 企業詳細、価格データ、評価指標、取引情報、配当、財務、パフォーマンス指標を含むJSONオブジェクト。

yfinance_get_ticker_news

特定の株式に関する最新のニュース記事やプレスリリースを取得します。

戻り値: タイトル、要約、公開日、プロバイダー、URL、サムネイルを含むニュース項目のJSON配列。

yfinance_search

Yahoo Financeで株式、ETF、ニュース記事を検索します。

戻り値: search_typeに応じた一致する銘柄および/またはニュース結果。

yfinance_get_top

市場セクター内でトップランクの金融エンティティを取得します。

戻り値: 関連指標を含むトップエンティティのJSON配列。

サポートされているセクター

Basic Materials (素材), Communication Services (通信サービス), Consumer Cyclical (一般消費財), Consumer Defensive (生活必需品), Energy (エネルギー), Financial Services (金融サービス), Healthcare (ヘルスケア), Industrials (資本財), Real Estate (不動産), Technology (テクノロジー), Utilities (公益事業)

yfinance_get_price_history

過去の価格データを取得し、オプションでテクニカル分析チャートを生成します。

チャートタイプ:

戻り値:

• chart_typeなし: 日付、始値、高値、安値、終値、出来高、配当、株式分割の列を含むMarkdownテーブル。

• chart_typeあり: トークン効率化のためのBase64エンコードされたWebP画像。

yfinance_get_financials

過去データを含む財務諸表（損益計算書、貸借対照表、キャッシュフロー）を取得します。

戻り値: 各報告期間の損益計算書、貸借対照表、キャッシュフローデータを含むJSONオブジェクト。

• 損益計算書フィールド: EBIT、純利益、法人税等、税引前利益、支払利息、総収益、営業利益、EBITDA、正規化純利益

• 貸借対照表フィールド: 株主資本、負債合計、現金および現金同等物、投下資本、純負債、資産合計、負債合計（非支配持分控除後）、有形資産純額、有形帳簿価額

• キャッシュフローフィールド: 営業キャッシュフロー、フリーキャッシュフロー、設備投資、継続事業からの純利益、減価償却費、運転資本の増減、支払配当金

使用方法

uv経由 (推奨)

1. uvをインストール

2. MCPクライアント設定に以下を追加します:

{
 "mcpServers": {
 "yfmcp": {
 "command": "uvx",
 "args": ["yfmcp@latest"]
 }
 }
}

Docker経由

{
 "mcpServers": {
 "yfmcp": {
 "command": "docker",
 "args": ["run", "-i", "--rm", "narumi/yfinance-mcp"]
 }
 }
}

ソースから

1. リポジトリをクローンし、依存関係をインストールします:

git clone https://github.com/narumiruna/yfinance-mcp.git
cd yfinance-mcp
uv sync

2. MCPクライアント設定に以下を追加します:

{
 "mcpServers": {
 "yfmcp": {
 "command": "uv",
 "args": [
 "run",
 "--directory",
 "/path/to/yfinance-mcp",
 "yfmcp"
 ]
 }
 }
}

/path/to/yfinance-mcpを、クローンしたリポジトリの実際のパスに置き換えてください。

開発

前提条件

• Python ≥ 3.12

• uv パッケージマネージャー

セットアップ

uv sync --extra dev

Lint & Format

uv run ruff check .
uv run ruff format .

型チェック

uv run ty check src tests

テスト

uv run pytest -v -s --cov=src tests

デモチャットボット

専用リポジトリのデモチャットボットをご覧ください: yfinance-mcp-demo

貢献者

contrib.rocksを使用して作成されました。

ライセンス

このプロジェクトはMITライセンスの下でライセンスされています。

Maintenance

Resources

• GitHub Repository
Need Help?
• Reddit Discussion
Related Servers

Tools

• yfinance_get_financialsA
• yfinance_get_holdersA
• yfinance_get_option_chainA
• yfinance_get_option_datesA
• yfinance_get_price_historyA
• yfinance_get_ticker_infoA
• yfinance_get_ticker_newsA
• yfinance_get_topA