Crazyrabbitltc MCP Coingecko Server

🚀 CoinGecko サーバー

このサーバーは、モデルコンテキストプロトコル（MCP）サーバーおよびOpenAI関数呼び出しサービスであり、CoinGecko Pro APIとのインタラクションに使用されます。

✨ 主な機能

• サポートされている暗号通貨をページング表示
• 名前またはシンボルでCoin IDを検索
• 過去の価格、時価総額、取引量のデータ
• OHLC（始値、高値、安値、終値）のローソク足データ
• リフレッシュ機能付きのローカルコインキャッシュ

📦 インストール

npm install coingecko-server

環境設定

プロジェクトのルートディレクトリに.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"
      }
    }
  }
}

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: "過去1週間のビットコインの価格履歴を取得" }],
  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 {
  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