Gaplydev01 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 統合情報

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

1. ローカルで CoinGecko API サーバーを起動します
2. Claude Desktop で、サーバーの URL（例：http://localhost:3000）を指定して MCP をインストールします
3. Claude が無料版と Pro 版の両方と互換性のある API にアクセスできるようになります

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

サーバーは直接 fetch 呼び出しを使用して CoinGecko API にアクセスするため、無料版と Pro 版の両方と互換性があります。

📄 ライセンス

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

謝辞

• CoinGecko - 暗号通貨データ API を提供してくれました
• Anthropic - Claude AI と MCP 計画を提供してくれました