Crazyrabbitltc MCP Coingecko Server

🚀 CoinGecko 服務器

CoinGecko 服務器是一個模型上下文協議（MCP）服務器和 OpenAI 函數調用服務，用於與 CoinGecko Pro API 交互，可助力用戶獲取各類加密貨幣數據。

🚀 快速開始

CoinGecko 服務器為用戶提供了便捷的方式與 CoinGecko Pro API 進行交互。通過以下步驟，你可以快速搭建並使用該服務器。

✨ 主要特性

• 分頁列出支持的加密貨幣，方便用戶按頁查看不同加密貨幣信息。
• 按名稱或符號查找 Coin ID，能快速定位特定加密貨幣。
• 提供歷史價格、市值和交易量數據，助力用戶進行市場分析。
• 提供 OHLC（開盤價、最高價、最低價、收盤價）燭臺數據，滿足專業交易分析需求。
• 具有刷新功能的本地硬幣緩存，可提高數據獲取效率。

📦 安裝指南

在項目中安裝 CoinGecko 服務器，可使用以下命令：

npm install coingecko-server

🔧 環境設置

在項目根目錄中創建一個 .env 文件，並設置 CoinGecko API 密鑰：

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"
      }
    }
  }
}

3. 重啟 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);

// 獲取函數定義
const functions = CoinGeckoService.getOpenAIFunctionDefinitions();

// 示例：獲取歷史數據
const response = await openai.chat.completions.create({
  model: "gpt-4-turbo-preview",
  messages: [{ role: "user", content: "獲取過去一週的比特幣價格歷史" }],
  functions: [functions[2]], // get_historical_data 函數
  function_call: "auto",
});

如果 (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
  );
}

數據類型說明

OHLCData

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

HistoricalData

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

CoinInfo

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

📚 詳細文檔

請參考 CoinGecko Pro API 文檔 以獲取當前的速率限制和使用指南。

📄 許可證

本項目採用 MIT 許可證。