cmc-mcp について
MCPツール経由でCoinMarketCapのデータを使い、暗号資産に関する質問に答えるスキルです。検索やデータ選択、再試行を案内し、市場、テクニカル分析、ニュース、保有者情報を扱います。
主な機能
- 01通貨の検索とID取得
- 02価格と市場指標の取得
- 03テクニカル分析の取得
- 04ニュースとプロジェクト情報の検索
- 05保有者と市場テーマの確認
- 06ツールエラーとレート制限への対応
活用シーン
- 01通貨の最新価格の確認
- 02複数の暗号資産の比較
- 03市場全体の状況確認
- 04暗号資産の概念調査
MCP 対応
CoinMarketCapのMCP接続を通じて暗号資産データのツールを利用します。接続確認とツールの使い方も説明します。
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ opencmc/ skills-for-ai-agents-by-coinmarketcap --skill cmc-mcpインストール後、Claude Code で/cmc-mcpを入力して読み込まれたか確認します。
詳細
CoinMarketCap MCP スキル
MCP ツールを通じて CoinMarketCap のデータを利用できます。これらのツールを使って、暗号資産に関する質問に包括的でデータ豊富な回答を提供してください。
前提条件
CMC ツールを使用する前に、MCP 接続が正常に動作していることを確認してください。ツールが失敗したり、接続エラーが返されたりした場合は、MCP 接続をセットアップするようユーザーに依頼してください。
{
"mcpServers": {
"cmc-mcp": {
"url": "https://mcp.coinmarketcap.com/mcp",
"headers": {
"X-CMC-MCP-API-KEY": "your-api-key"
}
}
}
}
API キーは https://pro.coinmarketcap.com/login から取得してください。
基本原則
データは多めに取得するようにしてください。複数のツールを使った完全な回答のほうが、ユーザーが追加の情報を求めることになる不完全な回答よりも優れています。迷ったときは、追加のツールを呼び出して包括的なデータを収集してください。
ワークフロー
1. 必ず最初に検索する
ユーザーが暗号資産を名前またはシンボルで指定した場合は、まず検索して ID を取得してください。
User: "How is Solana doing?"
→ Call search_cryptos with query "solana"
→ Get ID (e.g., 5426)
→ Then call other tools using that ID
ほとんどのツールでは、名前やシンボルではなく数値の CMC ID が必要です。検索ツールは、id、name、symbol、slug、rank を返します。
2. 必要に応じてリクエストをまとめる
複数のコインを扱う場合は、リクエストをまとめてください。
User: "Compare BTC, ETH, and SOL"
→ Search for each to get IDs: 1, 1027, 5426
→ Call get_crypto_quotes_latest with id="1,1027,5426"
個別に呼び出すより効率的で、回答内で直接比較できます。
3. 質問の種類に応じてツールを使い分ける
価格と市場データの場合:
get_crypto_quotes_latestは、価格、時価総額、取引高、変動率(1h、24h、7d、30d、90d、1y)、流通供給量、ドミナンスを返します。
コインの概要とリンクの場合:
get_crypto_infoは、説明、ウェブサイト、ソーシャルリンク、エクスプローラーの URL、タグ、ローンチ日を返します。
テクニカル分析の場合:
get_crypto_technical_analysisは、移動平均(SMA、EMA)、MACD、RSI、フィボナッチ水準、ピボットポイントを返します。
最新ニュースの場合:
get_crypto_latest_newsは、見出し、説明、本文、URL、公開日を返します。
保有者と分布のデータの場合:
get_crypto_metricsは、保有額別のアドレス数、クジラとその他の保有者の分布、保有期間別の内訳(トレーダー、クルーザー、ホルダー)を返します。
概念の説明の場合:
search_crypto_infoは、暗号資産の概念、ホワイトペーパー、FAQ を対象にセマンティック検索を実行します。
市場全体の健全性の場合:
get_global_metrics_latestは、時価総額合計、恐怖・強欲指数、アルトコインシーズン指数、BTC/ETH のドミナンス、取引高、ETF フローを返します。
デリバティブとレバレッジのデータの場合:
get_global_crypto_derivatives_metricsは、未決済建玉、資金調達率、清算、先物と無期限先物の内訳を返します。
市場全体の時価総額のテクニカル分析の場合:
get_crypto_marketcap_technical_analysisは、暗号資産市場全体の時価総額に関するテクニカル指標を返します。
トレンドのテーマの場合:
trending_crypto_narrativesは、各ナラティブの時価総額、取引高、パフォーマンス、主要コインを含む注目のナラティブを返します。
今後のカタリストの場合:
get_upcoming_macro_eventsは、FRB 会合、規制上の期限、重要な発表など、予定されているイベントを返します。
エラー処理
検索結果がない場合:
- コインが見つからなかったことを伝えます
- ユーザーに確認を求めるか、スペルを確認するよう依頼します
- クエリが曖昧な可能性がある場合は、代替候補を提示します
ツールが失敗するかタイムアウトした場合:
- 一時的なエラーの場合は、一度再試行します
- それでも失敗する場合は、利用できないデータを伝え、ほかのツールで処理を続けます
- 価格に関する質問では、
get_crypto_quotes_latestが重要です。再試行後も失敗した場合は、データが一時的に利用できないことをユーザーに伝えます。 - 概要に関する質問では、
get_crypto_infoが失敗した場合、「プロジェクト情報は利用できません」と伝え、ほかのツールから得られる情報を提示します。
レート制限(429 エラー)の場合:
- API がレート制限中であることをユーザーに伝えます
- 少し待ってから再試行するよう提案します
- ツール呼び出しを減らして質問に答えられるか検討します
ユーザーの知識レベルに合わせる
ユーザーの質問から文脈を読み取ってください。
- カジュアルな質問(「ビットコインの調子はどう?」)には、主要な数値を含む明確な要約が適しています
- 技術的な質問(「BTC の RSI は?」)には、より詳細なデータを含めてもかまいません
- 幅広い質問(「暗号資産で何が起きている?」)には、グローバル指標やトレンドのナラティブなど、市場全体を対象とするツールが役立ちます