yfinance-mcp
yfinance-mcp
あなたのAIのためのライブ市場データ。 Model Context Protocol サーバーで、Claude(または任意のMCPクライアント)にリアルタイムの株価、OHLCV履歴、完全なオプションチェーン、ニュース、複数ティッカーの比較を提供します。無料、APIキー不要。
なぜ
LLMはトレーニングデータの推測で市場の質問に答えます。このサーバーを一度接続すれば、推測はなくなります:
「Appleの現在の株価は?」 → 古い幻覚ではなくライブの株価
「来月期限のAAPLオプションを取得」 → IVとオープンインタレスト付きの実際のストライク
「NVDA vs AMD vs INTC 今年の比較?」 → データから計算された実際のリターン、ボラティリティ、ドローダウン
「PLTRに関する最近のニュースは?」 → 引用できるリンク付きの見出し
Related MCP server: YFinance MCP Server
ツール
ツール | 機能 | プロンプトの例 |
| 最終価格、日中レンジ、出来高、時価総額、52週レンジ、変化率 | 「今日のTSLAはどう?」 |
| OHLCVバー(任意の期間×間隔)+ サマリー統計 | 「2024年のSPY日次終値」 |
| コールとプット:ストライク、最終価格、bid/ask、IV、OI、出来高、ITM | 「来月のAAPLチェーン」 |
| 最近の見出しとリンク | 「PLTRに関するニュースは?」 |
| リターン、年率ボラティリティ、最大ドローダウンを並べて表示、勝者を指名 | 「MSFT vs GOOGL、3ヶ月」 |
レスポンスはJSONで、LLMに適したサイズに切り詰められます(オプションは片側60行まで)。サマリー統計が含まれるため、モデルは生のバーの前に集計値を基に推論できます。
セットアップ
git clone https://github.com/saksham10arora-dotcom/yfinance-mcp
cd yfinance-mcp
python3 -m venv .venv && .venv/bin/pip install fastmcp yfinanceClaude Desktop / 任意のMCPクライアント
claude_desktop_config.json に追加します(ファイル → 設定 → 開発者 → 設定を編集):
{
"mcpServers": {
"yfinance": {
"command": "/absolute/path/to/yfinance-mcp/.venv/bin/python",
"args": ["/absolute/path/to/yfinance-mcp/server.py"]
}
}
}Claude Desktopを再起動します。ツールは🔨アイコンの下に表示されます。任意のティッカーについて質問してください。
MCPクライアントなしで検証
./.venv/bin/python -c "import server; print(server.get_quote('AAPL'))"CIはプッシュのたびにGitHubと同じstdioハンドシェイクを実行するため、mainは常にプロトコルに準拠しています。
FAQ
データはリアルタイムですか? Yahoo Financeのデータ:米国株はほぼリアルタイム、一部の海外取引所では遅延があります。調査やチャットには適していますが、注文執行には適していません。
費用はかかりますか? いいえ。APIキーもレート制限アカウントも設定も不要です。
なぜチャットにyfinanceコードを貼り付けるだけではだめなのですか? できます。これによりコピーペーストのループがなくなり、モデルが質問ごとにどのツールを呼ぶかを決定できます。複数ステップの質問(「これらの5つのティッカーを比較して、最もボラティリティが高いもののチェーンを取得」など)も可能です。
Windowsは?
動作します。設定で.venv\Scripts\python.exeを指定し、JSONでは二重バックスラッシュを使用してください。
トラブルシューティング
再起動後にツールアイコンがない: 設定内のパスは絶対パスである必要があります。相対パスは静かに失敗します。
no data for <ticker>: 上場廃止またはスペルミスのシンボルです。ブラウザでYahoo Financeを確認してください。大量使用後のレート制限: 数分間待ってください。Yahooはバーストを制限します。
代替案との比較
yfinance-mcp | 有料市場MCP | |
APIキー | なし | 必須 |
コスト | 無料 | $10-100+/月 |
IV付きオプションチェーン | はい | 様々 |
リアルタイム深度/L2 | いいえ | 時々 |
セットアップ時間 | 2分 | アカウント + 請求 |
ライセンス
MIT。投資アドバイスではありません。あなたのポートフォリオを読むAIは受託者ではありません。
Related MCP Connectors
Market Data App MCP — wraps the Market Data App API (marketdata.app)
Finnhub MCP — wraps Finnhub Stock API (finnhub.io)
Official Intrinio MCP server. US stock prices, options and fundamentals for AI agents.
1Yahoo Finance for AI agents: quotes, price history, options with Greeks, financials, news, movers.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceProvides Yahoo Finance data including stock info, historical prices, dividends, financials, earnings, news, and more through a set of MCP tools, deployable on Azure Functions.-
- AlicenseNot gradedqualityDmaintenanceA comprehensive MCP server that provides seamless access to Yahoo Finance stock market data, enabling retrieval of real-time quotes, historical data, charts, financial summaries, and market searches.25 npmISC
- AlicenseAqualityDmaintenanceEnables querying stock data, financial information, news, and historical prices from Yahoo Finance through a set of MCP tools.5MIT
- AlicenseAqualityBmaintenanceMCP server that exposes Yahoo Finance data through tools for searching instruments, fetching quotes, history, company info, financials, dividends, news, recommendations, and options. Enables AI assistants to answer market-data questions using natural language.24579 PyPI2MIT