Alex2Yang97/yahoo-finance-mcp

This is a Model Context Protocol (MCP) server that provides comprehensive financial data from Yahoo Finance. It allows you to retrieve detailed information about stocks, including historical prices, company information, financial statements, options data, and market news.

Yahoo Finance MCP 서버

공개된 Yahoo Finance API를 감싸는 가벼운 Model Context Protocol (MCP) 서버로, LLM 기반 에이전트(예: Claude)가 풍부한 금융 데이터에 접근할 수 있도록 합니다. 서버는 LLM이 호출할 수 있는 타입이 지정된 도구 모음으로 노출되며, 다음과 같은 정보를 가져올 수 있습니다:

카테고리	도구(간단한 설명)
주식 정보	`get_historical_stock_prices` – OHLCV 시리즈; `get_stock_info` – 현재 가격, 지표, 회사 정보; `get_yahoo_finance_news` – 최신 뉴스; `get_stock_actions` – 배당금 및 분할
재무제표	`get_financial_statement` – 손익계산서, 대차대조표, 현금흐름표(연간/분기별); `get_holder_info` – 주요, 기관, 펀드, 내부자 보유자
옵션 데이터	`get_option_expiration_dates` – 이용 가능한 만기일; `get_option_chain` – 선택한 만기일에 대한 콜옵션/풋옵션
분석가 정보	`get_recommendations` – 분석가 평가, 상향/하향 조정

AI에 있어 중요한 이유

이 서버는 Claude for Desktop(또는 어떤 MCP 호환 모델이든)에서 호출되도록 설계되어, 모델이 최신 시장 데이터, 뉴스, 소유 정보를 보완하여 추론할 수 있게 합니다. 이로써 모델이 웹을 직접 크롤링하지 않아도 순수한 언어 모델이 금융 연구 보조자로 전환됩니다.

실제 사용 예시(README에서)

"지난 6개월 동안 NOW의 일일 간격으로 과거 주가를 보여주세요." → get_historical_stock_prices
"Intuit의 분기별 대차대조표를 가져와주세요." → get_financial_statement
"Intuit의 분석가 평가 중 최근 3개월 동안의 내용은 무엇인가요?" → get_recommendations
"2026-01-30 만기일을 가진 INTU의 콜옵션 체인을 가져와주세요." → get_option_chain

이 예시들은 LLM이 자연어 질문을 하면 MCP 서버가 이를 구체적인 API 호출로 번역할 수 있음을 보여줍니다.

시작하기

설치 없이 실행 – README는 uvx를 추천합니다:

uvx --from git+https://github.com/Alex2Yang97/yahoo-finance-mcp yahoo-finance-mcp

로컬 개발 – 복제 후 uv sync로 pyproject.toml에 나열된 종속성(파이썬 ≥ 3.14.6, mcp, yfinance, pandas, pydantic, …)을 설치하고 uv run server.py로 서버를 시작합니다.
Claude에 연결 – 위 명령어를 가리키는 yfinance MCP 항목을 claude_desktop_config.json에 추가한 후 Claude를 재시작합니다.

라이선스

MIT – 자유롭게 사용, 수정, 재배포 가능합니다.

모든 세부 사항은 저장소의 README에서 직접 인용되었습니다.