🚀 CoinGecko API サーバー MCP

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

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

🌟 概要

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

Related MCP server: Crypto Trader MCP Tool

✨ 主な特徴

• 🔄デュアルAPIサポート：CoinGeckoの無料版とPro版のAPIの両方とシームレスに統合

• 🧠 AI統合：AIアシスタント向けMCPプロトコルの完全実装

• 🛡️ インテリジェントフォールバック: レート制限を防ぐために API を自動的に切り替えます

• ⚡ 最適化されたパフォーマンス: 効率的なリクエスト処理とレスポンスのキャッシュ

• 📊 包括的なデータ：すべての重要な暗号通貨指標へのアクセス

• 🔌 シンプルなインターフェース: 直感的なRESTfulエンドポイントとJSON-RPCメソッド

• 🚦 堅牢なエラー処理: 適切なステータスコードでエラーメッセージをクリアします

• 🧩 簡単な導入：ガイド付きのセットアッププロセスによる最小限の構成

• 📘 豊富なドキュメント：明確な使用方法と例

🚀 クイックスタート

# Option 1: Install and run with npx
npx coingecko-api-server

# Option 2: Clone and install manually
git clone https://github.com/yourusername/coingecko-api-server.git
cd coingecko-api-server
npm install
npm run setup
npm start

📦 インストール

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

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

npx coingecko-api-server

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

1. 📥 サーバーをダウンロードしてインストールする

2. 🧰 対話型セットアップウィザードを実行する

3. 🔑 CoinGecko APIキーを尋ねる（オプション）

4. 🚀 サーバーを自動的に起動する

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

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

# Clone the repository
git clone https://github.com/yourusername/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ファイル内の環境変数を使用して構成されます。

📚 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で取得:

curl "http://localhost:3000/api/simple/price?ids=bitcoin&vs_currencies=usd"

応答：

{
  "bitcoin": {
    "usd": 45678.12
  }
}

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

curl "http://localhost:3000/api/coins/markets?vs_currency=usd&order=market_cap_desc&per_page=5&page=1"

🤖 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 を参照してください。

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

🧪 開発

# Run in development mode with hot reload
npm run dev

# Run tests
npm test

# Build for production
npm run build

🔄仕組み

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

1. リクエストルーティング: RESTfulおよびJSON-RPCクライアントからの受信リクエストを処理します

2. API選択: 構成に基づいて無料APIとPro APIを選択します

3. レート制限管理: インテリジェントなリクエストスロットリングを実装します

4. 応答処理: 一貫した構造でデータをフォーマットして返します

5. エラー処理: トラブルシューティングのための詳細なエラー情報を提供します

📱 ユースケース

• AI搭載ファイナンシャルアドバイザー：AIシステムがリアルタイムの暗号データにアクセスできるようにする

• 投資ダッシュボード：信頼性の高いデータアクセスを備えた暗号通貨ダッシュボードを構築

• ポートフォリオトラッカー：暗号資産保有を監視するアプリケーションを作成する

• 市場分析ツール：テクニカル分析とファンダメンタル分析のためのツールを開発する

• トレーディングボット：市場データで自動取引システムを強化

📄 ライセンス

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

🙏 謝辞

• 包括的な暗号通貨データAPIを提供するCoinGecko

• Claude AIとMCPプログラムのためのAnthropic

• オープンソースコミュニティの貴重な貢献

⬆ トップに戻る

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