coingecko-mcp-server

CoinGecko MCP Server

CoinGecko 用の MCP サーバーです。MCP 互換クライアントを接続して、無料の暗号資産市場データを利用できます。

これは何ですか？

CoinGecko の無料暗号資産市場データ API（価格、時価総額、トレンドのコイン、過去のデータ、世界全体の統計など）に、自然言語でアクセスできる MCP（Model Context Protocol） サーバーです。

Claude Desktop、Cursor、Windsurf、Cline、Continue、またはその他の MCP 互換クライアントで使用し、暗号資産市場について質問したり、トークンを比較したり、価格を追跡したりできます。

利用するメリット

• API キー不要 — CoinGecko の無料プランはすぐに利用できます（レート制限は約 27 回／分）
• 組み込みツール 8 種類 — よく使われる暗号資産データの問い合わせに対応します
• 見やすい Markdown 出力 — チャットで自然に読める結果を返します
• レート制限を自動管理 — 無料プランの制限を守り、429 エラー時には再試行します

ツール

ツール	説明
search_coins	名前またはシンボルで暗号資産を検索します
get_prices	1 つ以上のコインの現在価格、時価総額、24 時間の変動率を取得します
get_market_overview	時価総額上位 N 件のコインについて、詳細な統計情報を取得します
get_trending	現在トレンドになっているコインを取得します（過去 24 時間の検索ボリューム）
get_coin_details	特定のコインの詳細情報を取得します（説明、リンク、市場データ、カテゴリ）
get_price_history	価格の履歴データを取得します（日次、週次、月次、年次）
get_global_stats	暗号資産市場全体の統計情報を取得します（時価総額合計、BTC ドミナンス、稼働中の暗号資産数）
get_token_price_comparison	複数のトークンの価格と統計情報を並べて比較します

クイックスタート

1. MCP クライアントに追加する

MCP クライアントの設定（例：claude_desktop_config.json）に以下を追加します。

{
  "mcpServers": {
    "coingecko": {
      "command": "npx",
      "args": ["-y", "coingecko-mcp-server"]
    }
  }
}

これで完了です。API キーもインストール手順も不要です。npx が自動的にダウンロードして実行します。

2. 利用する

AI アシスタントに、次のような質問をしてみましょう。

• 「Bitcoin と Ethereum の現在価格はいくらですか？」
• 「時価総額上位 10 件のコインを表示して」
• 「今、CoinGecko でトレンドになっているのは？」
• 「Solana、Avalanche、Polkadot を比較して」
• 「Bitcoin の過去 30 日間のパフォーマンスは？」
• 「暗号資産市場全体の時価総額と BTC ドミナンスは？」
• 「AI 関連の暗号資産トークンを検索して」
• 「Chainlink について、カテゴリ、リンク、市場データを教えて」

出力例

get_trending

🔥 Trending Coins (last 24h):

1. Bitcoin (BTC) — Rank #1 | MCap: $1,340.2B | 24h: +2.1%
2. Ethereum (ETH) — Rank #2 | MCap: $412.8B | 24h: +1.8%
3. Solana (SOL) — Rank #5 | MCap: $78.4B | 24h: +4.3%
...

get_token_price_comparison

Token Comparison (USD):

| Coin | Price | MCap | 24h | 7d | Vol |
|------|-------|------|-----|-----|-----|
| Bitcoin (BTC) | $67,234 | $1,340.2B | +2.1% | +5.3% | $28,400M |
| Ethereum (ETH) | $3,456 | $412.8B | +1.8% | +3.1% | $14,200M |
| Solana (SOL) | $178.5 | $78.4B | +4.3% | +12.1% | $3,800M |

ユースケース

ポートフォリオ調査

保有資産を一覧にしたあと、「自分のポートフォリオの価値はいくら？」と尋ねてみましょう。このサーバーは複数のトークンの価格を比較し、時価総額、24 時間の変動率、取引高を含むスナップショットを提示します。

イールドファーミングの調査

「取引高の多いトレンドのコインを表示して」と尋ねれば、注目を集めているものを確認して新たな機会を見つけられます。get_coin_details と組み合わせて、投資を決める前にカテゴリやリンクを詳しく調べましょう。

市場情報の分析

「暗号資産市場全体の時価総額と BTC ドミナンスは？」と尋ねると、数秒でマクロな市場状況を把握できます。資産配分を決める前に、get_global_stats を利用しましょう。

トークンの比較

「Solana、Avalanche、Polkadotを比較」— 価格、時価総額、パフォーマンスデータを並べて比較できます。CoinGeckoで3つのタブを開くよりも速く確認できます。

過去の分析

「過去30日間のBitcoinのパフォーマンスは？」— トレンド分析用の日次価格履歴を確認できます（日次、週次、月次、年次など、あらゆる期間に対応しています）。

セキュリティ

• デフォルトではAPIキー不要 — CoinGeckoの無料プランを使用します。より高いレート制限が必要な場合は、オプションでAPIキーを設定できます。
• 読み取り専用 — CoinGeckoのAPIから公開市場データを取得するだけです。書き込みや変更は行いません。
• ローカルファイルへのアクセスなし — お使いのマシン上のファイルを読み取ったり、書き込んだりしません。
• シェルへのアクセスなし — コマンドを実行したり、プロセスを起動したりしません。
• レート制限あり — 無料プランの制限内に収まるよう、リクエストを自動的に制限します。
• オープンソース — MITライセンスです。GitHubでコードを確認できます。

トラブルシューティング

レート制限エラー（429）

サーバーは429エラーが発生すると自動的に再試行しますが、短時間に続けてクエリを行う場合は、リクエストの間に短い待ち時間を入れてください。無料プランでは、1分あたり約27回の呼び出しが可能です。このエラーが頻繁に発生する場合は、COINGECKO_API_KEYを設定して、より高い制限を利用してください。

「コインが見つかりません」エラー

まずsearch_coinsを使って、正しいCoinGecko IDを確認してください。コインIDは小文字のスラッグ（例：bitcoin、ethereum、solana）であり、ティッカーシンボルではありません。

サーバーが起動しない

Node.js 18以降がインストールされていることを確認してください：node --version。npxを使用している場合は、npmが最新であることを確認してください：npm install -g npm@latest。

MCPクライアントが接続できない

設定ファイルのパスが正しいことを確認してください。macOSではClaude Desktopは~/Library/Application Support/Claude/claude_desktop_config.jsonを、Windowsでは%APPDATA%\Claude\claude_desktop_config.jsonを使用します。設定を変更した後は、クライアントを再起動してください。

応答が遅い

CoinGeckoの無料プランでは、呼び出し1回あたり約300ミリ秒の遅延が発生します。複数のコインを対象とするクエリ（get_prices、get_token_price_comparison）では、渡すコインの数にかかわらずAPI呼び出しは1回だけです。そのため、クエリをまとめてください。

要件

• Node.js 18以降
• APIキー不要（CoinGeckoの無料プラン）

レート制限

サーバーはCoinGeckoの無料プランの制限内に収まるよう、リクエストを1分あたり約27回に自動制限します。CoinGecko Pro APIキーをお持ちの場合は、COINGECKO_API_KEY環境変数を設定すると、より高い制限を利用できます：

{
  "mcpServers": {
    "coingecko": {
      "command": "coingecko-mcp-server",
      "env": {
        "COINGECKO_API_KEY": "your_key_here"
      }
    }
  }
}

開発

git clone https://github.com/nova/coingecko-mcp-server.git
cd coingecko-mcp-server
npm install
npm run build
npm start

ライセンス

MIT