freemcplab / 디렉터리 / 플레이그라운드 / YFinance MCP

● 커뮤니티 narumiruna ⚡ 바로 사용

YFinance MCP

Name: YFinance MCP MCP Server
Author: narumiruna

제작: narumiruna · narumiruna/yfinance-mcp

Yahoo Finance via MCP — quotes, fundamentals, historical OHLC, options chains, news for any ticker, free.

Wraps the yfinance Python package as an MCP. No API key. Good for prototyping finance agents, backtesting ideas, or enriching research prompts with real market data. Data is delayed and rate-limited — not for production trading.

▶ 데모 보기 📦 설치 💡 사용 사례

왜 쓰나요

핵심 기능

No API key, no signup
Quotes, historical OHLC, fundamentals, balance sheets
Options chains, earnings dates, dividends
News headlines per ticker
Fast Python implementation via uvx

라이브 데모

실제 사용 모습

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

Quick snapshot of your watchlist — prices, P/E, news

👤 Investors doing daily check-ins ⏱ ~5 min beginner

언제 쓸까: You want a one-prompt briefing on 10 tickers before market open.

흐름

Prices

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
Fundamentals

For the same list, P/E, forward P/E, EPS, and dividend yield.✓ 복사됨

→ Fundamentals aligned with prior table
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

결과: A 10-line morning brief tailored to your watchlist.

함정

Rate-limited if you batch too many tickers at once — Chunk to 10 per call, sleep 1s between

함께 쓰기: memory

Backtest a simple strategy idea on historical prices

👤 Retail traders prototyping ⏱ ~20 min intermediate

언제 쓸까: You have an idea like "buy SPY when RSI < 30, sell at > 70" and want a quick historical sanity check.

흐름

Pull history

Pull 5y daily OHLC for SPY.✓ 복사됨

→ Time series returned as array
Compute

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
Reality check

Account for commissions ($1/trade) and slippage (5bps). Does the edge survive?✓ 복사됨

→ Net-of-costs figures

결과: A go/no-go decision on testing the idea further.

함정

Survivorship bias — only liquid tickers are in yfinance — For serious backtesting, use a dedicated dataset; yfinance is for sketching

함께 쓰기: alpaca

조합

다른 MCP와 조합해 10배 효율

yfinance-mcp + alpaca

yfinance for research, Alpaca for actual orders

Pick 3 ideas via yfinance, place paper trades via Alpaca.✓ 복사됨

yfinance-mcp + memory

Track your own thesis on tickers over time

Store the thesis on NVDA as of today, along with the price.✓ 복사됨

도구

이 MCP가 노출하는 것

도구	입력	언제 호출	비용
get_quote	ticker: str	Current price snapshot	free
get_history	ticker, period: str, interval: str	Historical data for charting or backtest	free
get_fundamentals	ticker	Valuation / fundamentals analysis	free
get_options	ticker, expiry?: date	Option chain lookup	free
get_news	ticker, limit?: int	Ticker-level headlines	free

비용 및 제한

운영 비용

API 쿼터: Yahoo's undocumented limits — avoid hammering
호출당 토큰: OHLC for 5y ≈ 50k tokens, keep requests focused
금액: Free
팁: Resample to weekly for longer histories; only pull daily when you need it

보안

권한, 시크릿, 파급범위

자격 증명 저장: None

데이터 외부 송신: query1.finance.yahoo.com

Yahoo has broken yfinance before with HTML changes — keep the package updated

문제 해결

자주 발생하는 오류와 해결

Returns empty / error for a ticker

Use Yahoo-format symbols (e.g. BRK-B not BRK.B); some exchanges need suffix (.T for Tokyo)

JSONDecodeError

Yahoo rate-limited you. Back off for a few minutes, or run fewer tickers per batch.

Package out of date

uvx --upgrade yfinance-mcp — Yahoo breaks things regularly

대안

YFinance MCP 다른 것과 비교

대안	언제 쓰나	단점/장점
Alpaca MCP	You want real brokerage data + order placement	Requires Alpaca account
Polygon / Finnhub	You need production-grade, low-latency data	Paid; no MCP (yet)