Coinmarketcap Fear & Greed Index

🚀 CoinMarketCap統一MCPサーバー

このプロジェクトは、モデルコンテキストプロトコル（MCP）サーバーで、CoinMarketCapの暗号通貨データへの全面的なアクセスを提供します。Cursorに簡単に統合でき、Cursor環境内で広範な暗号通貨データに直接アクセスできるように設計されています。

🚀 クイックスタート

このプロジェクトは、CursorのMCP機能とシームレスに統合することを目的としています。以下は、追加方法です。

1. リポジトリをクローンし、プロジェクトディレクトリに移動します。

   git clone https://github.com/yourusername/coinmarketcap-mcp.git
   cd coinmarketcap-mcp
   

2. 依存関係をインストールします。

   npm install
   

3. 環境変数を設定します。

   • プロジェクトのルートディレクトリに .env ファイルを作成します。

   • CoinMarketCap APIキーを追加します。

     CMC_API_KEY=YOUR_COINMARKETCAP_API_KEY
     CACHE_ENABLED=true
     CACHE_TTL=300
     

     YOUR_COINMARKETCAP_API_KEY を実際のAPIキーに置き換えてください。

4. サーバーをビルドして実行します。

   • 開発環境：

     npm run dev
     

   • 本番環境：

     npm run build
     npm start
     

5. Cursorに追加します。

   • Cursorを開きます。
   • 設定 > MCPに移動します。
   • 新しいサーバーを追加し、以下のように設定します。
     • タイプ: COMMAND
     • コマンド: node 絶対パス/dist/index.js

これで、Cursor内ですべての利用可能なツールを使用して、CoinMarketCapデータに直接アクセスできます！

✨ 主な機能

• 全面的なAPIカバレッジ：複数のCoinMarketCap APIエンドポイントにアクセスできます。
• スマートキャッシュ：API呼び出しを減らし、パフォーマンスを向上させます。
• 型安全：完全なTypeScriptサポートと、包括的な型定義が付属しています。
• モジュール化設計：拡張と保守が容易です。
• 詳細なエラー処理：明確なエラーメッセージとログが提供されます。

📦 インストール

依存関係のインストール

npm install

環境変数の設定

• プロジェクトのルートディレクトリに .env ファイルを作成します。
• CoinMarketCap APIキーを追加します。

CMC_API_KEY=YOUR_COINMARKETCAP_API_KEY
CACHE_ENABLED=true
CACHE_TTL=300

YOUR_COINMARKETCAP_API_KEY を実際のAPIキーに置き換えてください。

サーバーのビルドと実行

• 開発環境：

npm run dev

• 本番環境：

npm run build
npm start

💻 使用例

基本的な使用法

最新の暗号通貨リストを取得する

get_cryptocurrency_listings({
  limit: 10,
  convert: "USD"
})

特定の暗号通貨の価格を取得する

get_cryptocurrency_quotes({
  symbol: "BTC,ETH,SOL",
  convert: "USD"
})

恐怖と貪欲指数を取得する

get_fear_greed_index({
  limit: 7
})

グローバルな市場指標を取得する

get_global_metrics({
  convert: "USD"
})

📚 ドキュメント

利用可能なツール

暗号通貨データ

• get_cryptocurrency_listings - 最新の暗号通貨リストを取得します。
• get_cryptocurrency_quotes - 特定の暗号通貨の価格を取得します。
• get_cryptocurrency_info - 暗号通貨のメタデータを取得します。
• get_cryptocurrency_market_pairs - 暗号通貨の取引ペアを取得します。
• get_cryptocurrency_ohlcv - 過去のOHLCVデータを取得します。
• convert_cryptocurrency - 暗号通貨と法定通貨の間で変換します。

取引所データ

• get_exchange_listings - 最新の取引所リストを取得します。
• get_exchange_info - 詳細な取引所情報を取得します。
• get_exchange_map - すべての取引所のマップを取得します。

グローバルな市場データ

• get_global_metrics - グローバルな暗号通貨市場指標を取得します。

市場ムード

• get_fear_greed_index - 恐怖と貪欲指数データを取得します。

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

問題が発生した場合は、以下のことを確認してください。

1. 有効なCoinMarketCap APIキーを持っていることを確認します。
2. .env ファイルが正しく設定されていることを確認します。
3. コンソールログを確認して、詳細なエラー情報を取得します。
4. APIプランがアクセスしようとしているエンドポイントを許可していることを確認します。

📄 ライセンス

このプロジェクトは、MITライセンスに準拠しています。