Coingecko MCP Server

🚀 CoinGecko API サーバー MCP

強力で柔軟な Node.js Express サーバーで、CoinGecko の暗号通貨データ API への包括的なインターフェースを提供します。このサーバーは、無料の公共 API と Pro API をサポートし、自動フォールバック機能を備えています。

🚀 クイックスタート

# npx を使用してインストールして実行
npx coingecko-api-server

# または、クローンして手動でインストール
git clone https://github.com/GaplyDev01/coingecko-api-server.git
cd coingecko-api-server
npm install
npm run setup
npm start

✨ 主な機能

• 🔄 デュアル API サポート：CoinGecko の無料 API と Pro API をシームレスにサポート
• 🔙 自動フォールバック：開発中に自動的に無料 API にフォールバック
• 🔌 RESTful エンドポイント：シンプルで直感的な API インターフェース
• 🛡️ 強力なエラー処理：詳細なエラーメッセージと正しいステータスコード
• 🧩 簡単なセットアップ：ガイド付きのセットアップで迅速にインストール
• 📝 包括的なドキュメント：明確な使用説明

📦 インストール

オプション 1：npx を使用する（推奨）

これが最速の方法です。

npx coingecko-api-server

対話型セットアップでは、以下のことが行われます。

1. サーバーをインストールする場所を尋ねます。
2. リポジトリをクローンします。
3. 依存関係をインストールします。
4. CoinGecko API キーの入力を求めます（オプション）。
5. サーバーのポートを設定します。

オプション 2：手動でセットアップする

手動でセットアップする場合は、以下の手順を実行します。

# リポジトリをクローンする
git clone https://github.com/GaplyDev01/coingecko-api-server.git
cd coingecko-api-server

# 依存関係をインストールする
npm install

# セットアップスクリプトを実行する
npm run setup

# サーバーを起動する
npm start

🔧 設定

サーバーは .env ファイル内の環境変数を使用して設定できます。

📚 ドキュメント

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 ドキュメント で見ることができます。

MCP 統合情報

これは、Claude などの AI システムと互換性のある MCP（市場コンポーネント計画）サーバーです。Claude Desktop でこのサーバーを使用するには、以下の手順を実行します。

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

# ホットリロード付きで開発モードで実行する
npm run dev

このサーバーは、直接的な fetch 呼び出しを使用して CoinGecko API にアクセスし、無料版と Pro 版の両方との互換性を確保しています。

📄 ライセンス

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

謝辞

• CoinGecko は暗号通貨データ API を提供しています。
• Anthropic は Claude AI と MCP 計画を提供しています。