Coinmarketcap

CoinMarketCap API 向けの Model Context Protocol（MCP） サーバー実装です。暗号資産の市場データ、取引所情報、その他のブロックチェーン関連指標にアクセスするための標準化されたインターフェースを提供します。

特長

• CoinMarketCap API を完全にカバー
• 最新の暗号資産の動向、市場の変化、世界市場の指標に関するデータを取得
• Standard サブスクリプション以上で詳細な OHLCV データにアクセス
• Zod による型安全なパラメーター検証

前提条件

API キーをお持ちでない場合は、まずこちらから登録して、無料の Basic キーを取得してください。

クライアントの設定

MCP クライアントでこのサーバーを設定する方法はいくつかあります。ホスト型／リモートサーバーを設定するには、Smithery API キーを使用して Smithery の CLI を使います。ローカルにインストールする場合は、npx を使用するか、ソースからビルドしてください。それぞれの方法について以下で説明します。

Smithery リモートサーバー（推奨）

MCP クライアントの config.json にリモートサーバーを追加するには、Smithery CLI から次のコマンドを実行します。

npx -y @smithery/cli install @shinzo-labs/coinmarketcap-mcp

プロンプトが表示されたら、COINMARKETCAP_API_KEY と SUBSCRIPTION_LEVEL（以下の選択肢を参照）を入力してください。

Smithery SDK

独自のエージェントアプリケーションを開発している場合は、こちらのひな形コードを使用できます。

NPX によるローカルインストール

npx を使用してサーバーをローカルにインストールするには、MCP クライアントの config.json に以下を追加してください。

{
  "mcpServers": {
    "coinmarketcap": {
      "command": "npx",
      "args": [
        "@shinzolabs/coinmarketcap-mcp"
      ],
      "env": {
        "COINMARKETCAP_API_KEY": "your-key-here",
        "SUBSCRIPTION_LEVEL": "Basic" // See options below
      }
    }
  }
}

ソースからビルド

1. リポジトリをダウンロードします。

git clone https://github.com/shinzo-labs/coinmarketcap-mcp.git

2. パッケージをインストールします（クローンしたリポジトリ内で実行）。

pnpm i

3. MCP クライアントの config.json に以下を追加します。

{
  "mcpServers": {
    "coinmarketcap": {
      "command": "node",
      "args": [
        "/path/to/coinmarketcap-mcp/index.js"
      ],
      "env": {
        "COINMARKETCAP_API_KEY": "your-key-here",
        "SUBSCRIPTION_LEVEL": "Basic" // See options below
      }
    }
  }
}

設定変数

変数	説明	必須？	デフォルト
COINMARKETCAP_API_KEY	CoinMarketCap.com の API キー	はい
SUBSCRIPTION_LEVEL	Basic、Hobbyist、Startup、Standard、Professional、または Enterprise	いいえ	Basic
PORT	Streamable HTTP トランスポート方式のポート	いいえ	3000
TELEMETRY_ENABLED	テレメトリーを有効にする	いいえ	true

対応ツール

サブスクリプションレベル：Basic 以上

暗号資産

• cryptoCurrencyMap：すべての暗号資産のマッピングを取得します
• getCryptoMetadata：1つ以上の暗号資産のメタデータを取得します
• allCryptocurrencyListings：1～5000件の暗号資産の最新市場相場を取得します
• cryptoQuotesLatest：1つ以上の暗号資産の最新市場相場を取得します
• cryptoCategories：すべての暗号資産カテゴリーの一覧を取得します
• cryptoCategory：暗号資産カテゴリーのメタデータを取得します

取引所

• exchangeMap：すべての取引所のマッピングを取得します
• exchangeInfo：1つ以上の取引所のメタデータを取得します
• exchangeAssets：取引所で利用可能なすべての資産の一覧を取得します

DEX

• dexInfo：1つ以上の分散型取引所のメタデータを取得します
• dexListingsLatest：すべての DEX の最新市場データを取得します
• dexNetworksList：一意の ID を持つすべてのネットワークの一覧を取得します
• dexSpotPairsLatest：すべてのアクティブな DEX スポットペアの最新市場データを取得します
• dexPairsQuotesLatest：スポットペアの最新市場相場を取得します
• dexPairsOhlcvLatest：スポットペアの最新 OHLCV データを取得します
• dexPairsOhlcvHistorical：スポットペアの過去の OHLCV データを取得します
• dexPairsTradeLatest：スポットペアの最新取引を取得します

グローバル指標

• globalMetricsLatest：暗号資産の最新グローバル指標を取得します

インデックス

• cmc100IndexLatest：最新の CoinMarketCap 100 Index の値と構成銘柄を取得します
• cmc100IndexHistorical：CoinMarketCap 100 Index の過去の値を取得します

ツール

• priceConversion：暗号資産または法定通貨の金額を別の通貨に換算します
• getPostmanCollection：API の Postman コレクションを取得します

その他

• fiatMap：すべての法定通貨のマッピングを取得します
• keyInfo：API キーの使用状況とステータスを取得します
• fearAndGreedLatest：最新の Fear & Greed Index を取得します
• fearAndGreedHistorical：Fear & Greed Index の過去の値を取得します

サブスクリプションレベル：Hobbyist 以上

暗号資産

• cryptoAirdrops：すべての暗号資産エアドロップの一覧を取得します
• cryptoAirdrop：特定のエアドロップのメタデータを取得します
• historicalCryptocurrencyListings：任意の暗号資産の過去の市場相場を取得します
• cryptoQuotesHistorical：任意の暗号資産の過去の市場相場を取得します
• cryptoQuotesHistoricalV3：高度な時間ベースの間隔で過去の市場相場を取得します

取引所

• exchangeQuotesHistorical：任意の取引所の過去の相場を取得します

グローバル指標

• globalMetricsHistorical：暗号資産の過去のグローバル指標を取得します

サブスクリプションレベル：Startup 以上

暗号資産

• newCryptocurrencyListings：最近追加された暗号資産の一覧を取得します
• cryptoTrendingGainersLosers：指定した期間における値上がり率と値下がり率の上位銘柄を取得します
• cryptoTrendingLatest：検索ボリューム上位の暗号資産を取得します
• cryptoTrendingMostVisited：最も閲覧されている暗号資産を取得します
• cryptoOhlcvLatest：任意の暗号資産の最新 OHLCV 市場データを取得します
• cryptoOhlcvHistorical：任意の暗号資産の過去の OHLCV 市場データを取得します
• cryptoPricePerformanceStatsLatest：任意の暗号資産の最新の価格パフォーマンス統計を取得します

サブスクリプションレベル：Standard 以上

暗号資産

• cryptoMarketPairsLatest：任意の暗号資産の最新市場ペアを取得します

取引所

• exchangeListingsLatest：すべての取引所の最新市場データを取得します
• exchangeMarketPairsLatest：任意の取引所の最新市場ペアを取得します
• exchangeQuotesLatest：1つ以上の取引所の最新市場相場を取得します

コンテンツ

• contentLatest：暗号資産に関する最新のニュースとコンテンツを取得します
• contentPostsTop：暗号資産に関する人気の投稿を取得します
• contentPostsLatest：暗号資産に関する最新の投稿を取得します
• contentPostsComments：特定の投稿へのコメントを取得します

コミュニティ

• communityTrendingTopic：暗号資産コミュニティでトレンドのトピックを取得します
• communityTrendingToken：暗号資産コミュニティでトレンドのトークンを取得します

サブスクリプションレベル：Enterprise 以上

ブロックチェーン

• blockchainStatisticsLatest：1つ以上のブロックチェーンの最新統計を取得します

貢献

貢献を歓迎します！課題、貢献、連絡先に関するガイドラインについては、CONTRIBUTING.md をお読みください。

データ収集とプライバシー

Shinzo Labs は、製品とサービスの改善に役立てるため、このサーバーから限定的な匿名テレメトリーを収集します。このプロセスで個人を特定できる情報が収集されることはありません。収集するデータの種類と、このテレメトリーをオプトアウトする方法の詳細については、プライバシーポリシーをご確認ください。

ライセンス

MIT