crypto-feargreed-mcp

crypto-feargreed-mcp는 실시간 및 과거 암호화폐 공포 및 탐욕 지수(Crypto Fear & Greed Index) 데이터를 제공하는 MCP 서버입니다. 이 서버를 통해 Claude와 같은 AI 에이전트는 암호화폐 시장의 심리 상태를 분석하고 투자자들의 감정적 편향을 이해하는 데 도움이 되는 지표에 접근할 수 있습니다.

특징

• 실시간 지수: 현재 암호화폐 시장의 공포 및 탐욕 지수 제공
• 과거 데이터: 이전 기간의 공포 및 탐욕 지수 이력 조회
• 지수 해석: 지수 값의 의미와 시장 영향에 대한 해석
• 트렌드 분석: 시간에 따른 지수 변화 추세 분석
• 다양한 기간 지원: 일별, 주별, 월별 데이터 조회 가능
• 시각화 데이터: 그래프 생성을 위한 데이터 형식 제공
• 민감도 지표: 여러 요소에 대한 시장 민감도 측정

API

도구

현재 지수 조회

• get_current_index: 현재 암호화폐 공포 및 탐욕 지수 조회
• 입력: 없음

• 출력: 현재 지수 값(0-100), 분류(극도의 공포, 공포, 중립, 탐욕, 극도의 탐욕), 날짜

• interpret_current_index: 현재 지수 값 해석

• 입력: 없음
• 출력: 현재 지수에 대한 시장 분석 및 일반적인 영향 설명

과거 데이터 조회

• get_historical_index: 특정 기간의 과거 지수 데이터 조회

• 입력:

  • days (정수): 조회할 일수 (기본값: 30)
  • limit (정수): 반환할 최대 레코드 수 (선택적)

• 출력: 지정된 기간 동안의 일별 지수 데이터 목록

• get_average_index: 특정 기간의 평균 지수 계산

• 입력:

  • days (정수): 평균을 계산할 일수 (기본값: 7)

• 출력: 지정된 기간 동안의 평균 지수 값 및 분류

분석 및 인사이트

• analyze_trend: 지수 추세 분석

• 입력:

  • days (정수): 분석할 일수 (기본값: 30)

• 출력: 추세 방향, 변동성, 주요 전환점 등 분석 정보

• compare_with_price: 지수와 비트코인 가격 비교 분석

• 입력:

  • days (정수): 분석할 일수 (기본값: 30)

• 출력: 지수와 비트코인 가격 간의 상관관계 분석

사용 방법

설치

# 저장소 클론
git clone https://github.com/kukapay/crypto-feargreed-mcp.git
cd crypto-feargreed-mcp

# 의존성 설치
pip install -r requirements.txt

구성

Claude Desktop에서 이 서버를 사용하려면 다음과 같이 설정 파일에 추가합니다:

{
  "mcpServers": {
    "crypto-feargreed-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "/your/path/to/crypto-feargreed-mcp",
        "run",
        "main.py"
      ]
    }
  }
}

사용 예시

// 현재 공포 및 탐욕 지수 조회
const currentIndex = await get_current_index();
console.log(`현재 공포 및 탐욕 지수: ${currentIndex.value} (${currentIndex.classification})`);

// 현재 지수 해석
const interpretation = await interpret_current_index();
console.log(`시장 해석: ${interpretation}`);

// 과거 30일 데이터 조회
const historicalData = await get_historical_index({ days: 30 });
console.log(`과거 30일 지수 데이터: ${historicalData}`);

// 7일 평균 지수 계산
const weekAverage = await get_average_index({ days: 7 });
console.log(`7일 평균 지수: ${weekAverage.value} (${weekAverage.classification})`);

해석 가이드

공포 및 탐욕 지수는 0부터 100까지의 값으로 표시되며, 다음과 같이 분류됩니다:

• 0-25: 극도의 공포 (Extreme Fear) - 투자자들이 과도하게 두려워하는 상태, 잠재적 매수 기회일 수 있음
• 26-45: 공포 (Fear) - 시장에 불안감이 있으나 극단적이지는 않음
• 46-55: 중립 (Neutral) - 시장 심리가 균형 상태
• 56-75: 탐욕 (Greed) - 투자자들이 낙관적이며 더 많은 위험을 감수하려는 경향
• 76-100: 극도의 탐욕 (Extreme Greed) - 시장이 과열된 상태, 조정 가능성이 있음

한계 및 고려 사항

• 예측 도구 아님: 공포 및 탐욕 지수는 현재 시장 심리를 측정하는 도구이며, 미래 가격 움직임을 예측하지 않습니다.
• 데이터 소스 의존성: Alternative.me API에 의존하므로 원본 데이터 소스에 문제가 있을 경우 영향을 받을 수 있습니다.
• 심리 요소만 고려: 기술적, 기본적 분석 요소는 포함하지 않으므로 다른 분석 도구와 함께 사용하는 것이 좋습니다.
• 역사적 콘텍스트: 과거 지수 값과 현재 값의 비교는 시장 환경 변화를 고려해야 합니다.
• 갱신 주기: 지수는 일반적으로 24시간마다 갱신되므로 급격한 시장 변화를 즉시 반영하지 않을 수 있습니다.

연결된 구성 요소

• CoinMarketCap - 암호화폐 시장 데이터 및 가격 정보
• crypto-indicators-mcp - 다양한 암호화폐 기술 분석 지표
• crypto-sentiment-mcp - 암호화폐 관련 뉴스 및 감성 분석
• whale-tracker-mcp - 대규모 암호화폐 거래 추적