/ ディレクトリ / プレイグラウンド / YFinance MCP
← 全サーバー ↗ GitHub
● コミュニティ narumiruna ⚡ 即起動

YFinance MCP

作者 narumiruna · narumiruna/yfinance-mcp

MCP 経由の Yahoo Finance — 相場、ファンダメンタルズ、過去の OHLC、オプション チェーン、あらゆるティッカーのニュースを無料で提供。

yfinance Python パッケージを MCP としてラップします。 APIキーがありません。金融エージェントのプロトタイピング、アイデアのバックテスト、または実際の市場データを使用した調査プロンプトの充実に適しています。データは遅延し、レートが制限されています。実稼働取引には適していません。

▶ デモを見る 📦 インストール 💡 ユースケース

なぜ使うのか

主な機能

ライブデモ

実際の動作

yfinance-mcp.replay ▶ 準備完了
0/0

インストール

クライアントを選択

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "yfinance-mcp": {
      "command": "uvx",
      "args": [
        "yfinance-mcp"
      ]
    }
  }
}

Claude Desktop → Settings → Developer → Edit Config を開く。保存後、アプリを再起動。

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "yfinance-mcp": {
      "command": "uvx",
      "args": [
        "yfinance-mcp"
      ]
    }
  }
}

Cursor は Claude Desktop と同じ mcpServers スキーマを使用。プロジェクト設定はグローバルより優先。

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "yfinance-mcp": {
      "command": "uvx",
      "args": [
        "yfinance-mcp"
      ]
    }
  }
}

Cline サイドバーの MCP Servers アイコンをクリックし、"Edit Configuration" を選択。

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "yfinance-mcp": {
      "command": "uvx",
      "args": [
        "yfinance-mcp"
      ]
    }
  }
}

Claude Desktop と同じ形式。Windsurf を再起動して反映。

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "yfinance-mcp",
      "command": "uvx",
      "args": [
        "yfinance-mcp"
      ]
    }
  ]
}

Continue はマップではなくサーバーオブジェクトの配列を使用。

~/.config/zed/settings.json
{
  "context_servers": {
    "yfinance-mcp": {
      "command": {
        "path": "uvx",
        "args": [
          "yfinance-mcp"
        ]
      }
    }
  }
}

context_servers に追加。保存時に Zed がホットリロード。

claude mcp add yfinance-mcp -- uvx yfinance-mcp

ワンライナー。claude mcp list で確認、claude mcp remove で削除。

ユースケース

実用的な使い方： YFinance MCP

ウォッチリストのクイックスナップショット — 価格、PER、ニュース

👤 毎日チェックインを行う投資家 ⏱ ~5 min beginner

使うタイミング： 市場が開く前に、10 銘柄のティッカーに関する 1 回の説明が必要です。

フロー
  1. 価格
    Use yfinance-mcp. For AAPL, MSFT, NVDA, TSLA, GOOGL, AMZN, META, BRK-B, JPM, V — current price, 1d %, 52w range.✓ コピーしました
    → Clean table with all 10 rows
  2. 基本
    For the same list, P/E, forward P/E, EPS, and dividend yield.✓ コピーしました
    → Fundamentals aligned with prior table
  3. News
    For the 3 biggest movers today, pull the 3 most recent headlines each. Summarize the vibe.✓ コピーしました
    → News grouped by ticker with 1-line vibe

結果： ウォッチリストに合わせて作成された 10 行の朝のブリーフ。

注意点
  • Rate-limited if you batch too many tickers at once — Chunk to 10 per call, sleep 1s between
組み合わせ： メモリ

過去の価格に関するシンプルな戦略アイデアをバックテストする

👤 小売トレーダーのプロトタイピング ⏱ ~20 min intermediate

使うタイミング： 「RSI が 30 未満のときに SPY を買い、70 を超えたら売る」というようなアイデアがあり、過去の健全性を簡単にチェックしたいと考えています。

フロー
  1. プル履歴
    Pull 5y daily OHLC for SPY.✓ コピーしました
    → Time series returned as array
  2. コンピューティング
    Compute RSI(14). Run the "buy<30, sell>70" strategy. Report CAGR, max drawdown, trade count vs buy-and-hold.✓ コピーしました
    → Strategy metrics with honest comparison to baseline
  3. リアリティチェック
    Account for commissions ($1/trade) and slippage (5bps). Does the edge survive?✓ コピーしました
    → Net-of-costs figures

結果： アイデアをさらにテストするかどうかの決定。

注意点
  • Survivorship bias — only liquid tickers are in yfinance — For serious backtesting, use a dedicated dataset; yfinance is for sketching
組み合わせ： アルパカ

組み合わせ

他のMCPと組み合わせて10倍の力を

yfinance-mcp + alpaca

yfinance for research, Alpaca for actual orders

yfinance 経由で 3 つのアイデアを選択し、Alpaca 経由で紙の取引を行います。✓ コピーしました
yfinance-mcp + memory

Track your own thesis on tickers over time

今日の時点で論文を価格とともに NVDA に保存します。✓ コピーしました

ツール

このMCPが提供する機能

ツール入力呼び出すタイミングコスト
get_quote ticker: str 現在の価格のスナップショット free
get_history ticker, period: str, interval: str グラフ作成またはバックテスト用の履歴データ free
get_fundamentals ticker バリュエーション/ファンダメンタルズ分析 free
get_options ticker, expiry?: date オプションチェーンのルックアップ free
get_news ticker, limit?: int ティッカーレベルの見出し free

コストと制限

運用コスト

APIクォータ
Yahoo の文書化されていない制限 — ハンマーを避ける
呼び出しあたりのトークン
5 年 ≈ 50,000 トークンの OHLC、リクエストを集中させ続ける
金額
Free
ヒント
より長い履歴の場合は、毎週にリサンプリングします。毎日必要なときだけ引き出す

セキュリティ

権限、シークレット、影響範囲

認証情報の保管： None
データ送信先： query1.finance.yahoo.com

トラブルシューティング

よくあるエラーと対処法

ティッカーの場合は空またはエラーを返します

Yahoo 形式の記号を使用します (例: BRK.B ではなく BRK-B)。一部の取引所にはサフィックス（東京の場合は.T）が必要です

JSONデコードエラー

Yahooのレート制限付きのあなた。数分間停止するか、バッチごとに実行するティッカーの数を減らしてください。

パッケージが期限切れです

uvx --upgrade yfinance-mcp — Yahoo は定期的に物事を壊す

代替案

YFinance MCP 他との比較

代替案代わりに使う場面トレードオフ
Alpaca MCP実際の仲介データと注文が必要ですAlpacaアカウントが必要です
Polygon / Finnhub本番グレードの低遅延データが必要です有料; MCPは（まだ）ありません

その他

リソース

📖 GitHub の公式 README を読む

🐙 オープンな issue を見る

🔍 400以上のMCPサーバーとSkillsを見る