CoinMarketCap

CoinMarketCap MCP 서버는 CoinMarketCap API에 접근하여 암호화폐 시장 데이터, 거래소 정보 및 기타 블록체인 관련 지표를 제공합니다. 이 서버를 통해 Claude와 같은 AI 에이전트는 암호화폐 목록, 가격 정보, 시가총액, 거래량 등 다양한 암호화폐 데이터에 접근할 수 있습니다.

특징

• 암호화폐 목록: 활성 암호화폐의 페이지화된 목록 제공
• 상세 정보 조회: 특정 암호화폐의 상세 정보 및 시장 데이터
• 가격 정보: 다양한 통화로 표시된 암호화폐 가격 정보
• 시가총액 순위: 시가총액에 따른 암호화폐 순위 정보
• 거래량 데이터: 24시간, 7일 등의 거래량 통계
• 필터링 옵션: 가격, 시가총액, 거래량 등을 기준으로 한 필터링
• 멀티 통화 지원: 다양한 법정 화폐로 가격 정보 변환
• 거래소 정보: 암호화폐 거래소 목록 및 상세 정보
• 실시간 시장 동향: 시장 변동성, 상승/하락률 등의 트렌드 지표

API

도구

암호화폐 목록 및 정보

• listing-coins: 활성 암호화폐 목록 조회

• 입력:

  • start (정수, 선택적): 결과의 시작 오프셋 (1부터 시작)
  • limit (정수, 선택적): 반환할 결과 수 (기본값: 10, 최대: 5000)
  • price_min/price_max (숫자, 선택적): 가격 필터링 범위
  • market_cap_min/market_cap_max (숫자, 선택적): 시가총액 필터링 범위
  • convert (문자열, 선택적): 가격 변환 통화 (예: USD, EUR, BTC)

• 출력: 암호화폐 목록과 시장 데이터

• get-quotes: 특정 암호화폐의 가격 정보 조회

• 입력:

  • symbol/id/slug (문자열, 하나 이상 필요): 암호화폐 식별자
  • convert (문자열, 선택적): 가격 변환 통화

• 출력: 지정된 암호화폐의 현재 가격 정보

시장 및 거래소 데이터

• get-global-metrics: 글로벌 암호화폐 시장 지표 조회

• 입력:

  • convert (문자열, 선택적): 가격 변환 통화

• 출력: 글로벌 시가총액, 거래량, BTC 점유율 등의 정보

• list-exchanges: 암호화폐 거래소 목록 조회

• 입력:

  • start (정수, 선택적): 결과의 시작 오프셋
  • limit (정수, 선택적): 반환할 결과 수
  • sort (문자열, 선택적): 정렬 기준 (예: volume_24h, num_market_pairs)

• 출력: 거래소 목록 및 관련 정보

트렌드 및 분석

• get-trending: 인기 상승 중인 암호화폐 조회

• 입력: 없음

• 출력: 현재 인기 있는 암호화폐 목록

• get-price-performance: 가격 성능 지표 조회

• 입력:

  • symbol/id/slug (문자열): 암호화폐 식별자
  • time_period (문자열): 성능 측정 기간 (예: "24h", "7d", "30d", "1y")

• 출력: 지정된 기간 동안의 가격 성능 통계

사용 방법

설치

CoinMarketCap MCP 서버는 여러 가지 방법으로 설치할 수 있습니다:

# Smithery를 통한 자동 설치
npx -y @smithery/cli install coin-api-mcp --client claude

# 또는 저장소 클론 및 설치
git clone https://github.com/longmans/coin_api_mcp.git
cd coin_api_mcp
uv build
uv pip install .

구성

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

{
  "mcpServers": {
    "coin_api": {
      "command": "python",
      "args": ["-m", "coin_api_mcp"],
      "env": {
        "COINMARKETCAP_API_KEY": "your_api_key_here"
      }
    }
  }
}

API 키 설정

CoinMarketCap API 키는 CoinMarketCap 개발자 포털에서 무료로 얻을 수 있습니다. API 키는 다음 두 가지 방법으로 제공할 수 있습니다:

1. 환경 변수를 통해: COINMARKETCAP_API_KEY
2. 명령줄 인수를 통해: --api-key

사용 예시

// 상위 10개 암호화폐 목록 조회
const topCoins = await listing-coins({ limit: 10 });
console.log(`시가총액 상위 10개 암호화폐: ${topCoins}`);

// 비트코인과 이더리움 가격 조회
const cryptoPrices = await get-quotes({ 
  symbol: "BTC,ETH", 
  convert: "USD" 
});
console.log(`현재 비트코인 가격: ${cryptoPrices.BTC.quote.USD.price} USD`);
console.log(`현재 이더리움 가격: ${cryptoPrices.ETH.quote.USD.price} USD`);

// 글로벌 시장 지표 조회
const globalMetrics = await get-global-metrics({ convert: "USD" });
console.log(`글로벌 시가총액: ${globalMetrics.quote.USD.total_market_cap} USD`);

한계 및 고려 사항

• API 사용 제한: CoinMarketCap API는 구독 수준에 따라 요청 속도와 엔드포인트 제한이 있습니다.
• 데이터 정확성: 시장 데이터는 근실시간이지만, 약간의 지연이 있을 수 있습니다.
• API 키 필수: 서버 사용을 위해서는 유효한 CoinMarketCap API 키가 필요합니다.
• 구독 수준: 일부 고급 도구는 유료 구독이 필요할 수 있습니다.
• 통화 지원: 모든 법정 화폐가 지원되지 않을 수 있으므로 지원 여부를 확인해야 합니다.

연결된 구성 요소

• crypto-feargreed-mcp - 암호화폐 공포 및 탐욕 지수 데이터 제공
• crypto-indicators-mcp - 다양한 암호화폐 기술 분석 지표 제공
• crypto-sentiment-mcp - CryptoPanic에서 제공하는 최신 암호화폐 뉴스
• EVM MCP Server - 이더리움 및 기타 EVM 호환 블록체인과 상호작용