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 - 在加密货币和法定货币之间进行转换

交易所数据

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

全球市场数据

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

市场情绪

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

如何添加到 Cursor 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. 添加到 Cursor：

   • 打开 Cursor。
   • 转到 Settings > 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 计划有权访问您尝试使用的端点

许可证

MIT