Coingecko MCP Server

🚀 CoinGecko 服務器

CoinGecko 服務器是一個模型上下文協議（MCP）服務器和 OpenAI 函數調用服務，可用於與 CoinGecko Pro API 進行交互，為用戶提供豐富的加密貨幣數據服務。

🚀 快速開始

要使用 CoinGecko 服務器，你需要先完成安裝和環境配置，然後就可以根據自己的需求將其與 Claude Desktop 或 OpenAI 函數調用結合使用。

✨ 主要特性

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

📦 安裝指南

安裝依賴

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",
});

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
  );
}

📚 詳細文檔

數據類型

OHLCData

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

HistoricalData

interface HistoricalData {
  [key: string]: OHLCData[];
}

CoinInfo

interface CoinInfo {
  id: string;
  symbol: string;
  name: string;
  priceUsd: string;
  marketCapUsd: string;
  volumeUsd24Hr: string;
  latestUpdate: string;
}

速率限制

有關 API 調用的速率限制，請參考 CoinGecko Pro API 文檔。

📄 許可證

該庫在 MIT 許可證下發布。