金大哥 - CoinMarketCap Fear & Greed Index MCP 详情

article

README

🚀 CoinMarketCap 统一 MCP 服务器

该项目是一个模型上下文协议（MCP）服务器，能提供对 CoinMarketCap 加密货币数据的全面访问。它可轻松集成到 Cursor 中，让用户在 Cursor 环境里直接访问广泛的加密货币数据。

✨ 主要特性

全面 API 覆盖：可访问多个 CoinMarketCap API 端点。
智能缓存：减少 API 调用，提升性能。
类型安全：具备完整的 TypeScript 支持，还有全面的类型定义。
模块化设计：易于扩展和维护。
详细的错误处理：提供清晰的错误消息和日志。

📦 安装指南

该项目旨在与 Cursor 的 MCP 功能无缝集成。以下是添加方法：

克隆仓库并进入项目目录：

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

安装依赖项：
```
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
```
添加到 Cursor：
- 打开 Cursor。
- 转到设置 > MCP。
- 添加一个新的服务器，配置如下：
  - 类型：COMMAND
  - 命令：node 绝对路径/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"
})

📚 详细文档

可用工具

加密货币数据

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 - 获取恐惧与贪婪指数数据

📄 许可证

该项目遵守 MIT 许可证。

🔧 故障排除

如果遇到问题：

确保您有一个有效的 CoinMarketCap API 密钥。
检查 .env 文件是否正确配置。
查看控制台日志以获取详细的错误信息。
确保您的 API 计划允许访问您尝试使用的端点。

CoinMarketCap Fear & Greed Index