🚀 CoinGecko API サーバー MCP

AIシステムとアプリケーションへのシームレスな暗号通貨データアクセス

機能•クイックスタート•インストール•設定• APIリファレンス• MCP統合• Pro API •トラブルシューティング•ライセンス

🌟 概要

CoinGecko API Server MCPは、洗練されたRESTful APIとMCP（Marketplace Component Program）インターフェースを通じて、暗号通貨市場データへのシームレスなアクセスを提供する、パワフルで実稼働環境に対応したNode.jsソリューションです。ClaudeのようなAIシステムとリアルタイムの暗号通貨データを連携させながら、APIレート制限、フォールバック、エラー処理といった複雑な処理をすべて処理します。

✨ 主な特徴

• 🔄デュアルAPIサポート：CoinGeckoの無料版とPro版のAPIの両方とシームレスに統合
• 🧠 AI統合：AIアシスタント向けMCPプロトコルの完全実装
• 🛡️ インテリジェントフォールバック: レート制限を防ぐために API を自動的に切り替えます
• ⚡ 最適化されたパフォーマンス: 効率的なリクエスト処理とレスポンスのキャッシュ
• 📊 包括的なデータ：すべての重要な暗号通貨指標へのアクセス
• 🔌 シンプルなインターフェース: 直感的なRESTfulエンドポイントとJSON-RPCメソッド
• 🚦 堅牢なエラー処理: 適切なステータスコードでエラーメッセージをクリアします
• 🧩 簡単な導入：ガイド付きのセットアッププロセスによる最小限の構成
• 📘 豊富なドキュメント：明確な使用方法と例

🚀 クイックスタート

📦 インストール

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

始めるための最も早い方法:

これにより、次のようになります。

1. 📥 サーバーをダウンロードしてインストールする
2. 🧰 対話型セットアップウィザードを実行する
3. 🔑 CoinGecko APIキーを尋ねる（オプション）
4. 🚀 サーバーを自動的に起動する

オプション2: 手動インストール

インストール プロセスをより詳細に制御するには:

⚙️ 構成

サーバーは、 .envファイル内の環境変数を使用して構成されます。

📚 APIリファレンス

RESTfulエンドポイント

基本エンドポイント

• GET /api/ping - APIサーバーのステータスを確認する

価格データ

• GET /api/simple/price - 指定されたコインの価格データを取得する
  • クエリパラメータ: ids 、 vs_currencies 、 include_market_cap 、 include_24hr_vol 、 include_24hr_change 、 include_last_updated_at 、 precision

コインデータ

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

市場データ

• GET /api/global - グローバル暗号通貨データを取得する
• GET /api/search/trending - トレンドコインを取得

例

ビットコインの価格をUSDで取得:

応答：

時価総額上位5つの暗号通貨を入手:

🤖 AI統合（MCP）

このサーバーは Marketplace Component Program (MCP) プロトコルを実装し、Claude などの AI システムが暗号通貨データにアクセスできるようにします。

MCP統合ポイント

1. JSON-RPCエンドポイント: /rpc - AIクライアントからのメソッド呼び出しを処理します
2. スキーマ定義: /mcp/schema - 利用可能なツールとパラメータを定義します

利用可能なMCPメソッド

• ping - APIステータスを確認する
• getPrice - 指定された暗号通貨の価格データを取得する
• getSupportedVsCurrencies - サポートされている通貨のリストを取得する
• getCoinMarkets - コインの市場データを取得する
• getGlobal - 世界中の暗号通貨データを取得する
• getTrending - トレンドのコインを入手

詳細な統合手順については、 MCP_INTEGRATION.md を参照してください。

💎 プロAPIのメリット

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

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

🔧 トラブルシューティング

🧪 開発

🔄仕組み

サーバーは、アプリケーションと CoinGecko API 間のミドルウェアとして機能します。

1. リクエストルーティング: RESTfulおよびJSON-RPCクライアントからの受信リクエストを処理します
2. API選択: 構成に基づいて無料APIとPro APIを選択します
3. レート制限管理: インテリジェントなリクエストスロットリングを実装します
4. 応答処理: 一貫した構造でデータをフォーマットして返します
5. エラー処理: トラブルシューティングのための詳細なエラー情報を提供します

📱 ユースケース

• AI搭載ファイナンシャルアドバイザー：AIシステムがリアルタイムの暗号データにアクセスできるようにする
• 投資ダッシュボード：信頼性の高いデータアクセスを備えた暗号通貨ダッシュボードを構築
• ポートフォリオトラッカー：暗号資産保有を監視するアプリケーションを作成する
• 市場分析ツール：テクニカル分析とファンダメンタル分析のためのツールを開発する
• トレーディングボット：市場データで自動取引システムを強化

📄 ライセンス

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

🙏 謝辞

• 包括的な暗号通貨データAPIを提供するCoinGecko
• Claude AIとMCPプログラムのためのAnthropic
• オープンソースコミュニティの貴重な貢献

⬆ トップに戻る

[あなたの組織] が ❤️ で作成しました