Claude Desktop용 YFinance Trader MCP 도구

yfinance 라이브러리를 사용하여 주식 시장 데이터와 거래 기능을 제공하는 MCP(Model Context Protocol) 도구로, 특히 Claude Desktop에 맞춰 조정되었습니다.

출처 : 이 프로젝트는 Luigi Ajah의 mcp-stocks 에서 영감을 받았으며, 이는 Cursor와 유사한 구현 방식입니다. 이 변형은 Claude Desktop에서 작동하도록 원래 개념을 수정했습니다.

지도 시간

이 도구를 설정하고 사용하는 방법에 대한 자세한 가이드는 Medium 튜토리얼을 확인하세요: 튜토리얼: YFinance Trader MCP 도구와 함께 Claude Desktop을 사용하여 실시간 주식 시장 데이터에 액세스

특징

실시간 주식 시세
회사 정보 및 재무 지표
과거 가격 데이터
심볼 검색 기능
분석가 추천
내부자 거래 추적

설정

Python 3.10 이상이 설치되어 있는지 확인하세요.
종속성 설치:

지엑스피1

Claude Desktop과 통합

Claude Desktop에서 MCP 설정에 다음을 추가하여 MCP 설정을 구성하세요.

{
  "mcpServers": {
    "yfinance-trader": {
      "command": "py",
      "args": ["-3.13", "path/to/your/main.py"]
    }
  }
}

경로를 main.py 파일의 전체 경로로 바꾸세요.
필요한 경우 Claude Desktop을 다시 시작하세요.

사용 가능한 도구

1. 주식_견적_받기

실시간 주식 시세 정보를 받아보세요:

{
    "symbol": "AAPL",
    "price": 150.25,
    "change": 2.5,
    "changePercent": 1.67,
    "volume": 1234567,
    "timestamp": "2024-03-20T10:30:00"
}

2. 회사 개요 얻기

회사 정보와 주요 지표를 확인하세요.

{
    "name": "Apple Inc.",
    "sector": "Technology",
    "industry": "Consumer Electronics",
    "marketCap": 2500000000000,
    "peRatio": 25.4,
    "forwardPE": 24.2,
    "dividendYield": 0.65,
    "52WeekHigh": 182.94,
    "52WeekLow": 124.17
}

3. get_time_series_daily

일일 가격의 과거 데이터를 확인하세요:

{
    "symbol": "AAPL",
    "timeSeriesDaily": [
        {
            "date": "2024-03-20T00:00:00",
            "open": 150.25,
            "high": 152.30,
            "low": 149.80,
            "close": 151.75,
            "volume": 12345678
        }
        // ... more data points
    ]
}

4. 검색_기호

주식 및 기타 증권 검색:

{
    "results": [
        {
            "symbol": "AAPL",
            "name": "Apple Inc.",
            "type": "EQUITY",
            "exchange": "NASDAQ"
        }
        // ... more results
    ]
}

5. 추천 받기

주식에 대한 분석가 추천을 받으세요:

{
    "symbol": "AAPL",
    "recommendations": [
        {
            "period": "2024-03-15T00:00:00",
            "strongBuy": 15,
            "buy": 20,
            "hold": 8,
            "sell": 2,
            "strongSell": 0
        }
        // ... more periods
    ]
}

6. 내부자 거래 가져오기

내부자 거래 정보를 얻으세요:

{
    "symbol": "AAPL",
    "transactions": [
        {
            "date": "2024-03-15T00:00:00",
            "insider": "John Doe",
            "position": "Director",
            "transactionType": "Buy",
            "shares": 1000,
            "value": 150250.00,
            "url": "https://finance.yahoo.com/...",
            "text": "Purchase of 1000 shares",
            "startDate": "2024-03-15",
            "ownership": "Direct"
        }
        // ... more transactions
    ]
}

샘플 쿼리

Claude Desktop에게 다음과 같은 질문을 할 수 있습니다.

"AAPL의 현재 주가와 일일 변동폭은 얼마인가요?"
"Microsoft(MSFT)에 대한 회사 개요를 설명해 주시겠습니까?"
"지난 3개월 동안 Tesla(TSLA)의 과거 가격 데이터를 보여주세요."
"NVDA와 관련된 주식을 검색하세요."
"아마존(AMZN)에 대한 분석가 추천은 무엇인가요?"
"최근 구글(GOOGL)에서 내부 거래가 있었나요?"

암호화폐 지원

특수 티커 형식을 사용하면 제한된 암호화폐 데이터를 사용할 수 있습니다.

비트코인을 위한 BTC-USD
이더리움을 위한 ETH-USD
도지코인을 위한 DOGE-USD

오류 처리

모든 도구에는 적절한 오류 처리 기능이 포함되어 있으며 문제가 발생하면 오류 메시지를 반환합니다.

{
    "error": "Failed to fetch quote for INVALID_SYMBOL"
}

문제 해결

Claude Desktop에서 MCP 서버가 작동하지 않는 경우:

서버가 실행 중인지 확인하세요. 스크립트를 시작하면 출력이 표시되어야 합니다.
설정의 경로가 올바르고 절대적인지 확인하세요.
Python 3.10 이상이 시스템 PATH에 있는지 확인하세요.
모든 종속성이 설치되었는지 확인하세요
Claude Desktop을 다시 시작해 보세요.
오류 메시지가 있는지 로그를 확인하세요.

원래 mcp-stocks 프로젝트와의 차이점

FastAPI 대신 MCP 라이브러리를 직접 사용합니다.
커서 대신 Claude Desktop에 맞게 조정됨
수정된 오류 처리 및 응답 형식
업데이트된 구성 접근 방식

특허

MIT 라이센스

YFinance Trader MCP Tool

Integrations