🚀 CoinGecko API 서버 MCP

AI 시스템 및 애플리케이션을 위한 원활한 암호화폐 데이터 액세스

기능 • 빠른 시작 • 설치 • 구성 • API 참조 • MCP 통합 • Pro API • 문제 해결 • 라이센스

🌟 개요

CoinGecko API 서버 MCP는 강력한 프로덕션용 Node.js 솔루션으로, 우아한 RESTful API 및 MCP(Marketplace Component Program) 인터페이스를 통해 암호화폐 시장 데이터에 원활하게 접근할 수 있도록 지원합니다. Claude와 같은 AI 시스템과 실시간 암호화폐 데이터를 연결하는 동시에 API 속도 제한, 폴백 및 오류 처리의 모든 복잡성을 처리합니다.

✨ 주요 특징

• 🔄 듀얼 API 지원 : CoinGecko Free 및 Pro API와 완벽하게 통합됩니다.
• 🧠 AI 통합 : AI 어시스턴트를 위한 MCP 프로토콜의 완전한 구현
• 🛡️ 지능형 폴백 : 속도 제한을 방지하기 위해 API 간을 자동으로 전환합니다.
• ⚡ 최적화된 성능 : 효율적인 요청 처리 및 응답 캐싱
• 📊 포괄적인 데이터 : 모든 필수 암호화폐 지표에 대한 접근
• 🔌 간단한 인터페이스 : 직관적인 RESTful 엔드포인트 및 JSON-RPC 메서드
• 🚦 강력한 오류 처리 : 적절한 상태 코드로 명확한 오류 메시지 표시
• 🧩 간편한 배포 : 가이드 설정 프로세스를 통한 최소한의 구성
• 📘 광범위한 문서 : 명확한 사용 지침 및 예시

🚀 빠른 시작

지엑스피1

📦 설치

옵션 1: npx 사용(권장)

시작하는 가장 빠른 방법:

이렇게 하면:

1. 📥 서버를 다운로드하고 설치하세요
2. 🧰 대화형 설정 마법사 실행
3. 🔑 CoinGecko API 키를 요청하세요(선택 사항)
4. 🚀 서버를 자동으로 시작합니다

옵션 2: 수동 설치

설치 과정을 더욱 세부적으로 제어하려면 다음을 수행하세요.

⚙️ 구성

서버는 .env 파일의 환경 변수를 사용하여 구성됩니다.

📚 API 참조

RESTful 엔드포인트

기본 엔드포인트

• GET /api/ping - API 서버 상태 확인

가격 데이터

• GET /api/simple/price - 지정된 코인의 가격 데이터 가져오기
  • 쿼리 매개변수: ids , vs_currencies , include_market_cap , include_24hr_vol , include_24hr_change , include_last_updated_at , precision

코인 데이터

• GET /api/coins/markets - 코인 시장 데이터 가져오기
  • 쿼리 매개변수: vs_currency , ids , category , order , per_page , page , sparkline , price_change_percentage

시장 데이터

• GET /api/global - 글로벌 암호화폐 데이터 가져오기
• GET /api/search/trending - 트렌드 코인 가져오기

예시

비트코인 가격을 USD로 알아보세요:

응답:

시가총액 기준 상위 5개 암호화폐를 알아보세요:

🤖 AI 통합(MCP)

이 서버는 Claude와 같은 AI 시스템이 암호화폐 데이터에 액세스할 수 있도록 하는 Marketplace Component Program(MCP) 프로토콜을 구현합니다.

MCP 통합 지점

1. JSON-RPC 엔드포인트 : /rpc - AI 클라이언트의 메서드 호출을 처리합니다.
2. 스키마 정의 : /mcp/schema - 사용 가능한 도구 및 매개변수를 정의합니다.

사용 가능한 MCP 방법

• ping - API 상태 확인
• getPrice - 지정된 암호화폐에 대한 가격 데이터 가져오기
• getSupportedVsCurrencies - 지원되는 통화 목록 가져오기
• getCoinMarkets - 코인 시장 데이터 가져오기
• getGlobal - 글로벌 암호화폐 데이터 가져오기
• getTrending - 트렌드 코인 받기

자세한 통합 지침은 MCP_INTEGRATION.md를 참조하세요.

💎 Pro API 혜택

이 서버는 CoinGecko Pro API와 무료 API를 모두 지원합니다.

Pro API 설정에 대한 자세한 내용은 USING_COINGECKO_PRO.md를 참조하세요.

🔧 문제 해결

🧪 개발

🔄 작동 원리

서버는 애플리케이션과 CoinGecko API 사이의 미들웨어 역할을 합니다.

1. 요청 라우팅 : RESTful 및 JSON-RPC 클라이언트에서 들어오는 요청을 처리합니다.
2. API 선택 : 구성에 따라 무료 및 Pro API 중에서 선택합니다.
3. 속도 제한 관리 : 지능형 요청 제한을 구현합니다.
4. 응답 처리 : 일관된 구조로 데이터를 포맷하고 반환합니다.
5. 오류 처리 : 문제 해결을 위한 자세한 오류 정보를 제공합니다.

📱 사용 사례

• AI 기반 재무 자문가 : AI 시스템이 실시간 암호화 데이터에 액세스할 수 있도록 지원
• 투자 대시보드 : 안정적인 데이터 접근을 통해 암호화폐 대시보드 구축
• 포트폴리오 추적기 : 암호화폐 보유량을 모니터링하는 애플리케이션 만들기
• 시장 분석 도구 : 기술적 및 기본적 분석을 위한 도구 개발
• 트레이딩 봇 : 시장 데이터를 활용한 자동화된 트레이딩 시스템 구축

📄 라이센스

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

🙏 감사의 말

• 포괄적인 암호화폐 데이터 API를 제공하는 CoinGecko
• Claude AI와 MCP 프로그램을 위한 인류학
• 귀중한 기여를 해주신 오픈소스 커뮤니티

⬆ 위로 돌아가기

[귀하의 조직]이 ❤️로 만들었습니다