yfinance-mcp

AI를 위한 실시간 시장 데이터. Claude(또는 모든 MCP 클라이언트)에 실시간 시세, OHLCV 이력, 전체 옵션 체인, 뉴스, 다중 티커 비교를 제공하는 Model Context Protocol 서버입니다. 무료, API 키 불필요.

왜 필요한가

LLM은 훈련 데이터 기반의 추측으로 시장 질문에 답합니다. 이 서버를 한 번 연결하면 추측이 사라집니다:

• "애플 현재가가 얼마야?" → 낡은 환각 대신 실시간 시세

• "AAPL 다음 달 만기 옵션 불러와줘" → IV와 미결제약정이 포함된 실제 행사가

• "올해 NVDA vs AMD vs INTC?" → 데이터로 계산한 실제 수익률, 변동성, 최대 낙폭

• "PLTR 최근 뉴스 있어?" → 인용할 수 있는 링크가 포함된 헤드라인

Related MCP server: YFinance MCP Server

도구

응답은 JSON이며 LLM 친화적인 크기로 잘립니다(옵션은 방향당 최대 60행). 모델이 원시 봉 데이터보다 먼저 집계 통계로 추론할 수 있도록 요약 통계가 포함됩니다.

설치

git clone https://github.com/saksham10arora-dotcom/yfinance-mcp
cd yfinance-mcp
python3 -m venv .venv && .venv/bin/pip install fastmcp yfinance

Claude 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 코드를 채팅에 붙여넣으면 안 되나요? 그렇게 해도 됩니다. 이 서버는 복사-붙여넣기 반복을 없애고 모델이 질문별로 어떤 도구를 호출할지 스스로 결정하게 합니다. 다단계 질문("이 다섯 티커를 비교한 다음 가장 변동성이 큰 종목의 체인을 가져와")도 처리할 수 있습니다.

Windows? 동작합니다. 구성에서 .venv\Scripts\python.exe를 가리키고 JSON에서 이중 백슬래시를 사용하세요.

문제 해결

• 재시작 후 도구 아이콘 없음: 구성의 경로는 절대 경로여야 합니다. 상대 경로는 조용히 실패합니다.

• <ticker>에 데이터 없음: 상장폐지되었거나 철자가 틀린 심볼입니다. 브라우저에서 Yahoo Finance를 확인하세요.

• 과도한 사용 후 속도 제한: 몇 분간 쉬세요. Yahoo가 버스트를 제한합니다.

대안 비교

라이선스

MIT. 투자 조언이 아닙니다. 여러분의 포트폴리오를 읽는 AI는 수탁자가 아닙니다.