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 支持，附帶全面的類型定義
• 模塊化設計：易於擴展和維護
• 詳細的錯誤處理：清晰的錯誤消息和日誌

📦 安裝指南

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
     

💻 使用示例

基礎用法

獲取最新的加密貨幣列表

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 許可證。