CoinMarketCap Universal MCP Server

基本能力

产品定位

mcp-feargreedindex 是一个专注于加密货币数据的 MCP 服务器，提供从 CoinMarketCap 获取的多种加密货币数据服务。

核心功能

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

常见问题解答

1. API 密钥无效：确保你有一个有效的 CoinMarketCap API 密钥。
2. 环境变量配置错误：检查 .env 文件是否正确配置。
3. API 计划限制：确保你的 API 计划有权访问你尝试使用的端点。

使用教程

使用依赖

1. 确保已安装 Node.js 和 npm。
2. 克隆项目并进入项目目录： bash git clone https://github.com/yourusername/coinmarketcap-mcp.git cd coinmarketcap-mcp

安装教程

1. 安装依赖： bash npm install
2. 设置环境变量：
3. 在项目根目录创建 .env 文件。
4. 添加你的 CoinMarketCap API 密钥： CMC_API_KEY=YOUR_COINMARKETCAP_API_KEY CACHE_ENABLED=true CACHE_TTL=300
5. 构建并运行服务器：
6. 开发环境： bash npm run dev
7. 生产环境： bash npm run build npm start
8. 添加到 Cursor：
9. 打开 Cursor。
10. 转到 Settings > MCP。
11. 添加一个新服务器，配置如下：
    • Type: COMMAND
    • Command: node ABSOLUTE PATH/dist/index.js

调试方式

1. 检查控制台日志以获取详细的错误信息。
2. 确保 API 密钥和环境变量配置正确。
3. 验证 API 计划是否支持所使用的端点。

许可证

该项目遵循 MIT 开源许可条款。