Skip to main content
Glama
crazyrabbitLTC

CoinGecko MCP Server

코인게코 서버

CoinGecko Pro API와 상호 작용하기 위한 MCP(Model Context Protocol) 서버와 OpenAI 함수 호출 서비스입니다.

특징

  • 지원되는 암호화폐의 페이지별 목록

  • 이름이나 기호로 동전 ID 조회

  • 과거 가격, 시가총액 및 거래량 데이터

  • OHLC(시가, 고가, 저가, 종가) 캔들스틱 데이터

  • 새로 고침 기능이 있는 로컬 코인 캐시

Related MCP server: mcp-coinmarketcap

설치

지엑스피1

환경 설정

프로젝트 루트에 .env 파일을 만듭니다.

COINGECKO_API_KEY=your_api_key_here

Claude Desktop과 함께 사용

Claude Desktop은 MCP 기능을 완벽하게 지원합니다. 이 서버를 사용하려면 다음 단계를 따르세요.

  1. Claude Desktop 설치

  2. Claude Desktop 구성에 다음을 추가합니다.

    • macOS의 경우: ~/Library/Application Support/Claude/claude_desktop_config.json

    • Windows의 경우: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "coingecko": {
      "command": "node",
      "args": ["/path/to/coingecko-server/build/index.js"],
      "env": {
        "COINGECKO_API_KEY": "your-api-key-here"
      }
    }
  }
}
  1. Claude Desktop을 다시 시작하세요

서버는 다음과 같은 도구를 제공합니다.

  • get-coins : 지원되는 코인의 페이지별 목록을 가져옵니다.

  • find-coin-ids : 코인 이름/심볼에 대한 CoinGecko ID를 조회합니다.

  • get-historical-data : 과거 가격, 시가총액, 거래량 데이터를 가져옵니다.

  • get-ohlc-data : OHLC 캔들스틱 데이터 가져오기

  • refresh-cache : 로컬 코인 목록 캐시를 새로 고칩니다.

OpenAI 함수 호출 사용

import { CoinGeckoService } from 'coingecko-server';
import OpenAI from 'openai';

const openai = new OpenAI();
const coinGeckoService = new CoinGeckoService(process.env.COINGECKO_API_KEY);

// Get function definitions
const functions = CoinGeckoService.getOpenAIFunctionDefinitions();

// Example: Get historical data
const response = await openai.chat.completions.create({
  model: "gpt-4-turbo-preview",
  messages: [{ role: "user", content: "Get Bitcoin's price history for the last week" }],
  functions: [functions[2]], // get_historical_data function
  function_call: "auto",
});

if (response.choices[0].message.function_call) {
  const args = JSON.parse(response.choices[0].message.function_call.arguments);
  const history = await coinGeckoService.getHistoricalData(
    args.id,
    args.vs_currency,
    args.from,
    args.to,
    args.interval
  );
}

데이터 유형

OHLC데이터

interface OHLCData {
  timestamp: number;
  open: number;
  high: number;
  low: number;
  close: number;
}

역사 데이터

interface HistoricalData {
  prices: [number, number][];
  market_caps: [number, number][];
  total_volumes: [number, number][];
}

코인인포

interface CoinInfo {
  id: string;
  symbol: string;
  name: string;
  platforms?: Record<string, string>;
}

요금 제한

현재 요금 제한 및 사용 지침은 CoinGecko Pro API 문서를 참조하세요.

특허

MIT

Related MCP Connectors

  • Your agent needs crypto prices it can rely on — spot, ranked market tables, history, OHLC, per-venue tickers, and what is trending right now. **What you can ask for** • "What is the price of these 20 tokens in USD and EUR right now?" • "Give me the top 100 by market cap with 24h and 7d change." • "Chart this coin's price over the last year, hourly." • "Where does this token trade, and at what spread per venue?" • "What is trending on CoinGecko today?" **How to use it** Point any MCP client at https://mcp.aisa.one/crypto-market-data/mcp and sign in with OAuth — there is no key to create or paste. 21 CoinGecko tools: simple price and token price by contract, supported currencies, coin list and detail, ranked markets, history, market charts and ranges, OHLC, per-coin tickers, categories, exchanges and their tickers, token data and charts, and trending. **It is also a door to the rest** The same login reaches 26 sources and 580+ operations. Price the token here, then ask the same agent what X is posting about it — without adding a second server. **What it costs** Finding and inspecting an operation is free. Running one is billed per call at API prices, with no seat and no monthly minimum, and every call takes max_price_usd so an agent cannot overspend by accident. **Where else it reaches** https://mcp.aisa.one/finance/mcp for equities, crypto and prediction markets in one place.

  • CoinGecko MCP — wraps CoinGecko free API (no auth required)

  • Live and historical cryptocurrency prices via CoinGecko free API.

  • CoinGecko-backed live prices, market caps, DeFi metrics — no per-user API key needed.

Related MCP Servers

  • A
    license
    Not graded
    quality
    D
    maintenance
    Connects AI agents to real-time cryptocurrency market data from CoinGecko API, enabling price lookups, coin details, market rankings, search, and trending crypto queries through natural language.
    20 npm
    Apache 2.0
  • A
    license
    Not graded
    quality
    B
    maintenance
    Enables AI agents to query cryptocurrency data including prices, market cap, rankings, categories, and global metrics from CoinMarketCap via MCP tools.
    11 npm
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    Provides live and historical cryptocurrency prices, trending coins, and global market data via CoinGecko API, enabling AI agents to fetch real-time and historical crypto information.
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    Provides real-time cryptocurrency data from CoinGecko, including prices, market data, historical data, and coin search.
    5 npm
    MIT