CoinGecko API Server MCP

CoinGecko API Server MCP

CoinGecko の暗号資産データ API に包括的にアクセスできる、強力で柔軟な Node.js Express サーバーです。このサーバーは、無料の公開 API と Pro API の両方をサポートし、自動フォールバックにも対応しています。

クイックスタート

# Install and run with npx
npx coingecko-api-server

# Or clone and install manually
git clone https://github.com/GaplyDev01/coingecko-api-server.git
cd coingecko-api-server
npm install
npm run setup
npm start

機能

• 🔄 2 種類の API をサポート：CoinGecko の無料 API と Pro API の両方をシームレスに利用できます
• 🔙 自動フォールバック：開発中は無料 API にフォールバックします
• 🔌 RESTful エンドポイント：シンプルで直感的な API インターフェースです
• 🛡️ 堅牢なエラー処理：詳細なエラーメッセージと適切なステータスコードを提供します
• 🧩 簡単なセットアップ：ガイドに沿ってすばやくインストールできます
• 📝 包括的なドキュメント：分かりやすい使用方法を説明します

セットアップ方法

方法 1：npx を使用する（推奨）

最も簡単に始められる方法です。

npx coingecko-api-server

対話型セットアップでは、次の操作を行います。

1. サーバーのインストール先を指定します
2. リポジトリをクローンします
3. 依存関係をインストールします
4. CoinGecko API キーを入力します（任意）
5. サーバーのポートを設定します

方法 2：手動セットアップ

手動でセットアップする場合は、次の手順に従ってください。

# Clone the repository
git clone https://github.com/GaplyDev01/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_KEY	CoinGecko Pro API キー	-

API エンドポイント

このサーバーから、CoinGecko API の主要なエンドポイントを利用できます。

基本エンドポイント

• GET /api/ping - CoinGecko API のステータスを確認します

価格データ

• GET /api/simple/price - 指定したコインの価格データを取得します

  • クエリパラメーター：ids、vs_currencies、include_market_cap、include_24hr_vol、include_24hr_change、include_last_updated_at、precision

• GET /api/simple/supported_vs_currencies - 対応している vs 通貨の一覧を取得します

コインデータ

• GET /api/coins/markets - コインの市場データを取得します
  • クエリパラメーター：vs_currency、ids、category、order、per_page、page、sparkline、price_change_percentage

市場データ

• GET /api/global - 暗号資産の全体データを取得します
• GET /api/search/trending - トレンドのコインを取得します

API の詳細については、CoinGecko API Documentation をご覧ください。

MCP 連携について

このサーバーは、Claude などの AI システムと互換性のある MCP（Marketplace Component Program）サーバーです。このサーバーを Claude Desktop で使用するには、次の手順に従ってください。

1. CoinGecko API サーバーをローカルで起動します
2. Claude Desktop で、サーバー URL（例：http://localhost:3000）を指定して MCP をインストールします
3. これで Claude が MCP インターフェースを通じて暗号資産データにアクセスできるようになります

このサーバーは、JSON-RPC 2.0 を使用した MCP 仕様全体を実装しています。

• JSON-RPC 2.0 エンドポイント：/rpc - AI クライアントからのすべてのメソッド呼び出しを処理します
• スキーマ定義：/mcp/schema - 利用可能なツールとパラメーターを定義します
• 標準化された通信：スムーズな AI 連携のため、MCP プロトコルに準拠しています

詳細な連携手順については、MCP_INTEGRATION.md をご覧ください。

Pro API と無料 API

このサーバーは、CoinGecko Pro API と無料 API の両方をサポートしています。

• Pro API：レート制限が緩和され、スロットリングがなく、追加のエンドポイントを利用できます。API キーが必要です。
• 無料 API：1 分あたり約 30 回の呼び出しに制限され、レート制限が適用される場合があります。

サーバーは API キーの有無を自動的に検出し、適切な API を使用します。キーが指定されていない場合は無料 API にフォールバックするため、開発や個人利用に適しています。

Pro API のセットアップについて詳しくは、USING_COINGECKO_PRO.md をご覧ください。

開発

# Run in development mode with hot reload
npm run dev

このサーバーは CoinGecko API を直接 fetch で呼び出すため、無料版と Pro 版の両方との互換性が確保されます。

ライセンス

このプロジェクトは MIT ライセンスの下で公開されています。詳細については、LICENSE ファイルをご覧ください。

謝辞

• 暗号資産データ API を提供している CoinGecko
• Claude AI と MCP プログラムを提供している Anthropic