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

● 커뮤니티 narumiruna ⚡ 바로 사용

YFinance MCP

Name: YFinance MCP MCP Server
Author: narumiruna

제작: narumiruna · narumiruna/yfinance-mcp

MCP를 통한 Yahoo Finance — 시세, 기본 사항, 과거 OHLC, 옵션 체인, 모든 종목에 대한 뉴스가 무료입니다.

yfinance Python 패키지를 MCP로 래핑합니다. API 키가 없습니다. 금융 대리인의 프로토타입 제작, 아이디어 백테스팅 또는 실제 시장 데이터로 연구 프롬프트 강화에 적합합니다. 데이터는 지연되고 속도가 제한됩니다. 생산 거래에는 적합하지 않습니다.

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

왜 쓰나요

핵심 기능

API 키 없음, 가입 없음
시세, 역사적 OHLC, 펀더멘털, 대차대조표
옵션 체인, 수익 날짜, 배당금
티커당 뉴스 헤드라인
uvx를 통한 빠른 Python 구현

라이브 데모

실제 사용 모습

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

관심 목록의 빠른 스냅샷 — 가격, P/E, 뉴스

👤 매일 체크인하는 투자자 ⏱ ~5 min beginner

언제 쓸까: 시장 개장 전에 10개의 종목에 대한 단일 프롬프트 브리핑을 원합니다.

흐름

물가

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
기초

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

결과: 귀하의 관심 목록에 맞는 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에 판매"와 같은 아이디어가 있고 빠른 과거 건전성 확인을 원합니다.

흐름

풀 히스토리

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

→ Time series returned as array
컴퓨팅

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
현실 확인

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	Valuation / 펀더멘털 분석	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는 이전에 HTML 변경으로 yfinance를 중단했습니다. 패키지를 계속 업데이트하세요.

문제 해결

자주 발생하는 오류와 해결

티커에 대해 빈/오류를 반환합니다.

Yahoo 형식 기호를 사용합니다(예: BRK.B가 아닌 BRK-B). 일부 거래소에는 접미사가 필요합니다(도쿄의 경우 .T).

JSONDecode오류

Yahoo는 요금을 제한했습니다. 몇 분 동안 물러서거나 배치당 더 적은 수의 티커를 실행하십시오.

패키지가 오래됨

uvx --upgrade yfinance-mcp — Yahoo는 정기적으로 문제를 해결합니다.

대안

YFinance MCP 다른 것과 비교

대안	언제 쓰나	단점/장점
Alpaca MCP	실제 중개 데이터 + 주문 배치를 원합니다	알파카 계정이 필요합니다
Polygon / Finnhub	프로덕션 수준의 지연 시간이 짧은 데이터가 필요합니다.	유급의; MCP 없음(아직)