/ 目錄 / 演練場 / YFinance MCP
● 社群 narumiruna ⚡ 即開即用

YFinance MCP

作者 narumiruna · narumiruna/yfinance-mcp

透過 MCP 存取 Yahoo Finance——股票報價、基本面、歷史 OHLC、選擇權鏈、各個股新聞,完全免費。

將 yfinance Python 套件封裝為 MCP。無需 API 金鑰。適合打造金融 agent 原型、驗證回測想法,或以真實市場數據充實研究 prompt。資料有延遲且有速率限制——不適用於正式交易。

為什麼要用

核心特性

即時演示

實際使用效果

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

快速查看你的觀察清單——股價、本益比、新聞

👤 每日例行檢查的投資人 ⏱ ~5 min beginner

何時使用: 你想在開盤前用一個 prompt 獲得 10 檔股票的簡報。

步驟
  1. 股價
    Use yfinance-mcp. For AAPL, MSFT, NVDA, TSLA, GOOGL, AMZN, META, BRK-B, JPM, V — current price, 1d %, 52w range.✓ 已複製
    → 包含所有 10 列的整齊表格
  2. 基本面
    For the same list, P/E, forward P/E, EPS, and dividend yield.✓ 已複製
    → 基本面數據與前一個表格對齊
  3. 新聞
    For the 3 biggest movers today, pull the 3 most recent headlines each. Summarize the vibe.✓ 已複製
    → 依股票分組的新聞,附有一行概括

結果: 專為你的觀察清單客製的 10 行晨間簡報。

注意事項
  • 一次批次太多股票觸發速率限制 — 每次呼叫最多 10 檔,中間停 1 秒
搭配使用: memory

用歷史股價回測一個簡單策略想法

👤 建立原型的散戶交易者 ⏱ ~20 min intermediate

何時使用: 你有一個想法,例如「RSI < 30 買入 SPY,> 70 賣出」,想快速做歷史合理性驗證。

步驟
  1. 取得歷史資料
    Pull 5y daily OHLC for SPY.✓ 已複製
    → 時間序列以陣列回傳
  2. 計算
    Compute RSI(14). Run the "buy<30, sell>70" strategy. Report CAGR, max drawdown, trade count vs buy-and-hold.✓ 已複製
    → 策略指標,附有與基準的誠實比較
  3. 現實檢驗
    Account for commissions ($1/trade) and slippage (5bps). Does the edge survive?✓ 已複製
    → 扣除成本後的數字

結果: 決定是否值得進一步測試該想法的 go/no-go 結論。

注意事項
  • 倖存者偏差——yfinance 只有流動性好的股票 — 嚴肅的回測請使用專業資料集;yfinance 只適合初步草稿
搭配使用: alpaca

組合

與其他 MCP 搭配,撬動十倍槓桿

yfinance-mcp + alpaca

yfinance 負責研究,Alpaca 負責下真實訂單

Pick 3 ideas via yfinance, place paper trades via Alpaca.✓ 已複製
yfinance-mcp + memory

長期追蹤你對特定股票的投資論點

Store the thesis on NVDA as of today, along with the price.✓ 已複製

工具

此 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 的未公開限制——避免高頻呼叫
每次呼叫 Token 數
5 年 OHLC 約 50k tokens,請保持查詢聚焦
費用
免費
提示
較長時間段改用週線資料;只在必要時使用日線

安全

權限、密鑰、影響範圍

憑證儲存:
資料出站: query1.finance.yahoo.com

故障排查

常見錯誤與修復

Returns empty / error for a ticker

使用 Yahoo 格式的股票代碼(例如 BRK-B 而非 BRK.B);部分交易所需要後綴(東京市場用 .T)

JSONDecodeError

Yahoo 對你進行了速率限制。退避幾分鐘,或減少每批次的股票數量。

Package out of date

uvx --upgrade yfinance-mcp——Yahoo 經常改版破壞套件

替代方案

YFinance MCP 對比其他方案

替代方案何時用它替代權衡
Alpaca MCP你需要真實的券商資料加上下單功能需要 Alpaca 帳號
Polygon / Finnhub你需要生產級、低延遲資料付費;尚未有 MCP

更多

資源

📖 閱讀 GitHub 上的官方 README

🐙 查看未解決的 issue

🔍 瀏覽全部 400+ MCP 伺服器和 Skills