MCP 야후 파이낸스

Yahoo Finance 상호작용을 위한 모델 컨텍스트 프로토콜 (MCP) 서버입니다. 이 서버는 가격, 회사 정보, 재무 시각화 생성 도구를 제공합니다.

이 프로젝트는 maxscheijen/mcp-yahoo-finance 의 포크이자 확장 프로젝트로, 시각화 기능이 추가되었습니다.

특징

재무 데이터 : 현재 주가, 과거 주가, 배당금, 손익 계산서 등을 확인하세요.
시각적 분석 : 시장 심리, 포트폴리오 추적 및 기술 분석을 위한 아름다운 시각화를 생성합니다.
간편한 통합 : Claude Desktop, VS Code, Cursor 및 기타 MCP 클라이언트와 호환됩니다.

설치 지침

1. 저장소 복제

이 저장소를 로컬 컴퓨터에 복제하세요.

지엑스피1

2. 종속성 설치

pip를 사용하여 필요한 종속성을 설치합니다.

pip install -r requirements.txt

requirements.txt 파일이 없으면 종속성을 직접 설치할 수 있습니다.

pip install mcp yfinance pandas matplotlib seaborn plotly kaleido numpy pillow base64io

3. MCP 클라이언트 구성

클로드 데스크탑

claude_desktop_config.json 에 다음을 추가하세요(존재하지 않으면 만드세요).

macOS/Linux : ~/Library/Application Support/Claude/claude_desktop_config.json
윈도우 : %APPDATA%\Claude\claude_desktop_config.json

{
    "mcpServers": {
        "yahoo-finance": {
            "command": "uvx",
            "args": ["mcp-yahoo-finance"]
        }
    }
}

docker를 사용할 수도 있습니다.

{
    "mcpServers": {
        "yahoo-finance": {
            "command": "docker",
            "args": ["run", "-i", "--rm", "IMAGE"]
        }
    }
}

VS코드

.vscode/mcp.json 에 다음을 추가하세요:

{
    "servers": {
        "yahoo-finance": {
            "command": "uvx",
            "args": ["mcp-yahoo-finance"]
        }
    }
}

커서

커서 MCP 구성에 다음을 추가하세요.

{
    "mcp-servers": {
        "yahoo-finance": {
            "command": "uvx",
            "args": ["mcp-yahoo-finance"]
        }
    }
}

4. MCP 클라이언트를 다시 시작하세요

구성 후 Claude Desktop이나 선호하는 MCP 클라이언트를 다시 시작하여 서버를 로드하세요.

사용 가능한 도구

기본 재무 데이터

get_current_stock_price : 특정 심볼의 현재 주가를 가져옵니다.
get_stock_price_by_date : 특정 날짜의 주가를 가져옵니다
get_stock_price_date_range : 특정 날짜 범위의 주가를 가져옵니다.
get_historical_stock_prices : 사용자 정의 가능한 기간으로 과거 주식 데이터 가져오기
get_dividends : 주식에 대한 배당금 정보를 가져옵니다.
get_income_statement : 손익계산서 데이터 가져오기
get_cashflow : 현금 흐름 명세서 데이터 가져오기
get_earning_dates : 수입 날짜 정보 받기
get_news : 주식에 대한 최신 뉴스를 받아보세요

시각화 도구

generate_market_dashboard : 실시간 지수 성과를 보여주는 시장 심리 대시보드를 만듭니다.
generate_portfolio_report : 포트폴리오 성과 추적 보고서 생성
generate_stock_technical_analysis : 주식에 대한 기술 분석 보고서를 생성합니다.

시각화 예

시장 심리 대시보드

포트폴리오 추적

주식 기술적 분석

예시 프롬프트

클로드에게 시도해 볼 수 있는 몇 가지 프롬프트 예시는 다음과 같습니다.

기본 재무 데이터

"애플의 현재 주가는 얼마인가요?"
"애플과 구글의 주가 차이는 얼마입니까?"
"2025년 1월 1일부터 2025년 3월 31일까지 Apple 주가는 얼마나 변동했나요?"

시각화 요청

주요 지수의 성과를 보여주는 시장 심리 대시보드를 생성합니다.
"AAPL, MSFT, GOOGL, AMZN, NVDA 등 기술 주식에 대한 포트폴리오 추적 보고서를 만들어 보세요."
"이동 평균선과 지지/저항 수준을 포함한 테슬라 주식의 기술적 분석 차트를 보여주세요."
"S&P 500, Dow Jones, NASDAQ를 활용한 시장 심리 대시보드를 생성하세요."
"XOM, CVX, BP, COP, SLB 등 에너지 주식에 대한 포트폴리오 보고서를 만들어 주실 수 있나요?"
"RSI와 거래량 패턴을 보여주는 NVDA 주식에 대한 자세한 기술적 분석이 필요합니다."

테스트

시각화 기능을 테스트하려면:

cd tests
python test_visualization.py

이렇게 하면 examples 디렉토리에 예제 시각화 이미지가 생성됩니다.

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.

감사의 말

Max Scheijen 의 오리지널 프로젝트
tooyipjee 에서 영감을 받은 시각화 기능으로 확장됨

MCP Yahoo Finance

Integrations