Skip to main content
Glama
deenesjakoruzh

CoinGecko

by BlindVibeDev
GitHub
JavaScript
MIT License
3
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

🚀 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 사용(권장)

시작하는 가장 빠른 방법:

npx coingecko-api-server

이렇게 하면:

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

옵션 2: 수동 설치

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

# Clone the repository git clone https://github.com/yourusername/coingecko-api-server.git cd coingecko-api-server # Install dependencies npm install # Run the setup script npm run setup # Start the server npm start

⚙️ 구성

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

변하기 쉬운설명기본
PORT서버 포트3000
COINGECKO_API_KEYCoinGecko Pro API 키(선택 사항)-
CACHE_DURATION캐시 기간(초)60
LOG_LEVEL로깅 수준(오류, 경고, 정보, 디버그)info

📚 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로 알아보세요:

curl "http://localhost:3000/api/simple/price?ids=bitcoin&vs_currencies=usd"

응답:

{ "bitcoin": { "usd": 45678.12 } }

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

curl "http://localhost:3000/api/coins/markets?vs_currency=usd&order=market_cap_desc&per_page=5&page=1"

🤖 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를 모두 지원합니다.

특징무료 API프로 API
요금 제한~30통화/분~500통화/분
API 제한예아니요
지원하다지역 사회우선 사항
데이터 신선도10~30분1~2분
가격무료신청

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

🔧 문제 해결

문제해결책
속도 제한 오류Pro API로 업그레이드하거나 요청 빈도를 조정하는 것을 고려하세요.
연결이 거부되었습니다서버가 지정된 포트에서 실행 중인지 확인하세요.
인증 오류.env 파일에서 API 키를 확인하세요
누락된 데이터요청의 매개변수를 확인하세요

🧪 개발

# Run in development mode with hot reload npm run dev # Run tests npm test # Build for production npm run build

🔄 작동 원리

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

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

📱 사용 사례

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

📄 라이센스

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

🙏 감사의 말

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

⬆ 위로 돌아가기

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

This server cannot be installed

-
security - not tested
A
license - permissive license
-
quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

CoinGecko 암호화폐 데이터 API에 대한 포괄적인 인터페이스를 제공하는 강력하고 유연한 Node.js Express 서버입니다. 이 서버는 무료 공개 API와 자동 폴백 기능을 갖춘 Pro API를 모두 지원합니다.

  1. 🌟 개요
    1. ✨ 주요 특징
      1. 🚀 빠른 시작
        1. 📦 설치
          1. 옵션 1: npx 사용(권장)
          2. 옵션 2: 수동 설치
        2. ⚙️ 구성
          1. 📚 API 참조
            1. RESTful 엔드포인트
            2. 예시
          2. 🤖 AI 통합(MCP)
            1. MCP 통합 지점
            2. 사용 가능한 MCP 방법
          3. 💎 Pro API 혜택
            1. 🔧 문제 해결
              1. 🧪 개발
                1. 🔄 작동 원리
                  1. 📱 사용 사례
                    1. 📄 라이센스
                      1. 🙏 감사의 말

                        Related Resources

                        Related MCP Servers

                        • Tiny Cryptography MCP Server

                          anton10xr
                          -
                          security
                          F
                          license
                          -
                          quality
                          A Model Context Protocol server built with Express.js that provides cryptographic tools including key pair generation, shared secret derivation, and message encryption/decryption.
                          Last updated -
                          160
                          JavaScript

                        • CoinGecko API Server MCP

                          GaplyDev01
                          -
                          security
                          A
                          license
                          -
                          quality
                          A Node.js Express server that provides access to CoinGecko's cryptocurrency data through a comprehensive API interface, supporting both free and Pro APIs with automatic fallback functionality.
                          Last updated -
                          1
                          JavaScript
                          MIT License

                        • Realtime Crypto MCP Server

                          smhnkmr
                          -
                          security
                          -
                          license
                          -
                          quality
                          A server that provides real-time cryptocurrency data through the Model Context Protocol, allowing access to detailed exchange information and current cryptocurrency rates from the CoinCap API.
                          Last updated -
                          1
                          TypeScript
                          MIT License

                        View all related MCP servers

                        Appeared in Searches

                        New MCP Servers

                        MCP directory API

                        We provide all the information about MCP servers via our MCP API.

                        curl -X GET 'https://glama.ai/api/mcp/v1/servers/BlindVibeDev/CoinGeckoMCP'

                        If you have feedback or need assistance with the MCP directory API, please join our Discord server