고래 추적 MCP 서버

Whale Alert API를 사용하여 암호화폐 고래 거래를 추적하기 위한 MCP(Model Context Protocol) 서버

목차

• 개요
• 특징
• 필수 조건
• 설치
• 용법
  • 개발 모드에서 실행
  • Claude Desktop과 통합
  • 직접 실행
• 예시
• API 키 구성
• 특허
• 감사의 말

개요

whale-tracker-mcp 서버는 Whale Alert API 와 통합되는 모델 컨텍스트 프로토콜(MCP) 의 Python 기반 구현입니다. Claude Desktop과 같은 MCP 호환 클라이언트에 도구, 리소스 및 프롬프트를 제공하여 대규모 암호화폐 거래("고래" 움직임)를 실시간으로 추적하고 분석할 수 있습니다.

이 서버는 LLM 기반 워크플로 내에서 고래 활동을 직접 모니터링하고자 하는 암호화폐 애호가, 개발자 및 분석가를 위해 설계되었습니다.

특징

• 도구 :
  • get_recent_transactions : 블록체인, 최소값, 한도에 대한 선택적 필터를 사용하여 최근 고래 거래를 가져옵니다.
  • get_transaction_details : ID로 특정 거래에 대한 자세한 정보를 검색합니다.
• 자원 :
  • whale://transactions/{blockchain} : 지정된 블록체인의 최근 거래를 문맥적 데이터로 표시합니다.
• 프롬프트 :
  • query_whale_activity : 고래 거래 패턴을 분석하기 위한 재사용 가능한 템플릿으로, 블록체인으로 선택적으로 필터링할 수 있습니다.
• 비동기 API 호출 : Whale Alert API에 대한 효율적이고 차단되지 않는 요청을 위해 httpx 사용합니다.
• 환경 변수 지원 : .env 파일을 통해 API 키를 안전하게 관리하세요.

필수 조건

• Python : 버전 3.10 이상.
• Whale Alert API 키 : whale-alert.io 에 가입하여 API 키를 받으세요.
• MCP 클라이언트 : Claude Desktop이나 MCP Inspector와 같은 MCP 클라이언트와 호환됩니다.

설치

1. 저장소를 복제합니다 .

지엑스피1

2. 종속성 설치: 종속성 관리를 위해 uv를 사용하는 것이 좋습니다.

또는 pip를 사용하세요:

3. API 키 설정: 프로젝트 루트에 .env 파일을 만들고 Whale Alert API 키를 추가합니다.

용법

개발 모드에서 실행

MCP 검사기를 사용하여 로컬로 서버를 테스트하세요.

이렇게 하면 서버의 도구, 리소스, 프롬프트를 탐색할 수 있는 웹 인터페이스가 열립니다.

Claude Desktop과 통합

원활한 통합을 위해 Claude Desktop에 서버를 설치하세요.

• --name "WhaleTracker" : Claude Desktop의 서버에 대한 사용자 정의 이름을 설정합니다.
• -f .env : .env 파일에서 API 키를 로드합니다.

설치 후 Claude Desktop을 다시 시작하세요. 입력란에서 망치 아이콘을 찾아 서버가 로드되었는지 확인한 후, 다음 명령어를 시도해 보세요.

• "비트코인에 대한 최근 고래 거래를 보여주세요."
• "거래 ID 123456789에 대한 세부 정보를 얻으세요."
• "이더리움에서 고래 활동을 분석합니다."

직접 실행

사용자 정의 배포를 위해 서버를 독립 실행형으로 실행합니다.

또는 MCP CLI를 사용하세요.

예시

Claude Desktop에서 서버와 상호 작용하는 방법은 다음과 같습니다.

최근 거래 내역 가져오기:

서버는 blockchain="ethereum" 및 min_value=1000000 으로 get_recent_transactions 호출합니다.

거래 세부 정보 받기:

서버는 get_transaction_details 사용하여 거래 데이터를 가져와서 표시합니다.

고래 활동 분석:

query_whale_activity 프롬프트는 whale://transactions/bitcoin 리소스를 기반으로 분석을 트리거합니다.

API 키 구성

서버에는 WHALE_ALERT_API_KEY 환경 변수에서 로드되는 Whale Alert API 키가 필요합니다. 구성 방법은 다음과 같습니다.

• .env 파일을 만듭니다.

• python-dotenv 설치되어 있는지 확인하세요(종속성에 포함됨).
• 서버는 시작 시 자동으로 키를 로드합니다.

또는 서버를 실행할 때 키를 직접 전달하세요.

특허

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

감사의 말

• 암호화폐 고래 거래를 추적하는 API를 제공해준 Whale Alert 에 감사드립니다.
• MCP 사양 및 Python SDK를 위한 모델 컨텍스트 프로토콜 팀입니다.
• 강력한 HTTP 클라이언트 라이브러리인 httpx .

즐거운 고래 추적 되세요! 🐳