加密货币数据服务

CoinMarketCap Universal MCP Server 是一个提供全面加密货币数据访问的模型上下文协议(MCP)服务器,支持在Cursor环境中直接集成和使用。

  • by heyzgj
  • TypeScript
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 heyzgj/mcp-feargreedindex

使用说明

CoinMarketCap通用MCP服务器

该项目是一个模型上下文协议(MCP)服务器,提供对CoinMarketCap加密货币数据的全面访问。它旨在轻松集成到Cursor中,允许您直接在Cursor环境中访问各种加密货币数据。

特性

  • API全面覆盖:访问多个CoinMarketCap API端点
  • 智能缓存:减少API调用并提高性能
  • 类型安全:完全支持TypeScript,具有全面的类型定义
  • 模块化设计:易于扩展和维护
  • 详细错误处理:清除错误消息和日志记录

可用工具

加密货币数据

  • get_cryptocurrency_listings -获取最新的加密货币列表
  • get_cryptocurrency_quotes -获取特定加密货币的报价
  • get_cryptocurrency_info -获取加密货币的元数据
  • get_cryptocurrency_market_pairs -获取加密货币的市场对
  • get_cryptocurrency_ohlcv -获取历史OHLCV数据
  • convert_cryptocurrency -在加密货币和法定货币之间转换

Exchange数据

  • get_exchange_listings -获取最新交易所列表
  • get_exchange_info -获取详细的交易信息
  • get_exchange_map -获取所有交易所的地图

全球市场数据

  • get_global_metrics -获取全球加密货币市场指标

市场情绪

  • get_fear_greed_index -获取恐惧与贪婪指数数据

如何添加到光标MCP

该项目旨在与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. 添加到光标:

    • 打开光标。
    • 转到“设置”>“MCP”。
    • 添加具有以下配置的新服务器:
      • 类型: COMMAND
      • 命令: node ABSOLUTE PATH/dist/index.js

现在,您可以直接在Cursor中使用所有可用的工具来访问CoinMarketCap数据!

使用示例

获取最新的加密货币列表

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"
})

故障排除

如果您遇到问题:

  1. 确保您拥有有效的CoinMarketCap API密钥
  2. 检查一下 .env 文件配置正确
  3. 查看控制台日志以获取详细的错误信息
  4. 确保您的API计划可以访问您尝试使用的端点

许可证

麻省理工学院