whale-tracker-mcp

whale-tracker-mcp는 Whale Alert API를 사용하여 암호화폐 고래 거래(큰 금액의 트랜잭션)를 추적하기 위한 MCP 서버입니다. 이 서버는 MCP 호환 클라이언트(예: Claude Desktop)에서 대규모 암호화폐 거래를 실시간으로 모니터링하고 분석할 수 있게 해줍니다.

특징

• 실시간 고래 거래 추적: Whale Alert API를 통해 대규모 암호화폐 트랜잭션을 실시간으로 모니터링
• 다중 블록체인 지원: 비트코인, 이더리움, 리플 등 다양한 블록체인에서 발생하는 고래 활동 추적
• 사용자 정의 필터링: 블록체인, 최소 거래 금액, 결과 수 등으로 거래 검색 필터링
• 상세 트랜잭션 정보: 특정 트랜잭션 ID에 대한 상세 정보 제공
• 트랜잭션 패턴 분석: 고래 거래 패턴을 분석하는 재사용 가능한 프롬프트 제공

API

도구

get_recent_transactions

• 설명: 선택적 필터를 적용하여 최근 고래 트랜잭션을 가져옵니다
• 입력:
• blockchain: 블록체인 유형(예: "bitcoin", "ethereum" 등, 기본값: 모든 블록체인)
• min_value: 최소 거래 금액(USD, 기본값: 500000)
• limit: 결과 수(기본값: 10)
• 출력: 시간, 블록체인, 금액, 송신자/수신자 주소, 해시 등 트랜잭션 목록

get_transaction_details

• 설명: ID로 특정 트랜잭션의 상세 정보를 검색합니다
• 입력:
• transaction_id: 트랜잭션 ID
• 출력: 트랜잭션의 상세 정보(시간, 블록체인, 금액, 송신자/수신자 정보, 해시 등)

리소스

whale://transactions/{blockchain}

• 설명: 특정 블록체인의 최근 트랜잭션을 컨텍스트 데이터로 노출합니다
• 예: whale://transactions/bitcoin, whale://transactions/ethereum 등

프롬프트

query_whale_activity

• 설명: 블록체인별로 선택적으로 필터링된 고래 트랜잭션 패턴을 분석하는 재사용 가능한 템플릿
• 예시 쿼리:
• "비트코인에서 최근 10개의 고래 트랜잭션을 분석해주세요"
• "이더리움에서 최소 1백만 달러 이상의 거래를 찾아주세요"

사용 방법

설치

# pip를 사용하여 설치
pip install whale-tracker-mcp

# 또는 소스에서 설치
git clone https://github.com/kukapay/whale-tracker-mcp.git
cd whale-tracker-mcp
pip install -r requirements.txt

구성

서버를 실행하기 위해서는 Whale Alert API 키가 필요합니다:

1. whale-alert.io에서 API 키를 발급받습니다.
2. 다음 방법 중 하나로 API 키를 설정합니다:
3. .env 파일에 WHALE_ALERT_API_KEY=your_api_key_here 추가
4. 또는 서버 실행 시 직접 환경 변수로 전달

Claude Desktop과 통합하려면:

# 서버 설치
mcp install whale_tracker.py --name "WhaleTracker" -f .env

필요 조건

• Python 3.10 이상
• Whale Alert API 키
• Claude Desktop 또는 다른 MCP 호환 클라이언트

사용 예시

Claude Desktop에서 다음과 같은 명령을 시도해볼 수 있습니다:

• "최근 고래 트랜잭션을 보여주세요"
• "비트코인 네트워크에서 발생한 700만 달러 이상의 트랜잭션을 조회해주세요"
• "이더리움에서 발생한 가장 큰 10개의 거래를 보여주세요"
• "트랜잭션 ID 123456789에 대한 정보를 알려주세요"
• "최근 24시간 동안의 고래 활동 패턴을 분석해주세요"

연결된 구성 요소

• uniswap-trader-mcp - Uniswap DEX에서 토큰 스왑을 자동화하는 MCP 서버
• uniswap-poolspy-mcp - Uniswap에서 새로 생성된 유동성 풀을 추적하는 MCP 서버
• token-minter-mcp - 다양한 블록체인에서 ERC-20 토큰을 발행하는 MCP 서버
• token-revoke-mcp - ERC-20 토큰 허용량을 확인하고 취소하기 위한 MCP 서버
• EVM MCP Server - 30개 이상의 EVM 네트워크에 대한 포괄적인 블록체인 서비스