CoinMarketCap MCP

CoinMarketCap MCP

site icon
2025.04.04 2
JavaScript加密货币市场数据区块链金融服务
CoinMarketCap MCP 是一个基于 Model Context Protocol (MCP) 的实现,专门用于访问 CoinMarketCap API 提供的加密货币市场数据、交易所信息以及其他区块链相关指标。它提供了一个标准化的接口,方便开发者获取最新的加密货币趋势、市场动态和全球市场指标。
View on GitHub

Overview

基本能力

产品定位

CoinMarketCap MCP 是一个专门用于访问 CoinMarketCap API 的标准化接口,旨在为开发者提供便捷的加密货币市场数据访问能力。

核心功能

  • 完整的 CoinMarketCap API 覆盖
  • 获取最新的加密货币趋势、市场动态和全球市场指标
  • 访问详细的 OHLCV 数据(需要 Standard 订阅或更高)
  • 使用 Zod 进行类型安全的参数验证

适用场景

  • 加密货币市场数据分析
  • 交易所信息查询
  • 区块链相关指标监控
  • 加密货币价格转换

工具列表

  • priceConversion: 将一种加密货币或法定货币的金额转换为另一种货币
  • getPostmanCollection: 获取 API 的 Postman 集合

常见问题解答

  • 需要 API 密钥才能使用,可以通过 CoinMarketCap 官网 申请免费的 Basic 密钥。
  • 建议使用 Heimdall 来限制暴露给客户端应用程序的端点数量。

使用教程

使用依赖

  • 需要 Node.js 环境
  • 需要 API 密钥

安装教程

NPX(推荐)

在 MCP 客户端的 config.json 文件中添加以下内容:

{
  "mcpServers": {
    "coinmarketcap": {
      "command": "npx",
      "args": [
        "@shinzolabs/coinmarketcap-mcp"
      ],
      "env": {
        "COINMARKETCAP_API_KEY": "your-key-here",
        "SUBSCRIPTION_LEVEL": "Basic" // "Basic", "Hobbyist", "Startup", "Standard", "Professional", or "Enterprise"
      }
    }
  }
}

手动下载

  1. 下载仓库:
git clone https://github.com/shinzo-labs/coinmarketcap-mcp.git
  1. 安装依赖(在克隆的仓库内):
pnpm i
  1. 在 MCP 客户端的 config.json 文件中添加以下内容:
{
  "mcpServers": {
    "coinmarketcap": {
      "command": "node",
      "args": [
        "/path/to/coinmarketcap-mcp/index.js"
      ],
      "env": {
        "COINMARKETCAP_API_KEY": "your-key-here",
        "SUBSCRIPTION_LEVEL": "Basic" // "Basic", "Hobbyist", "Startup", "Standard", "Professional", or "Enterprise"
      }
    }
  }
}

Smithery

通过 Smithery 自动安装:

npx -y @smithery/cli install @shinzo-labs/coinmarketcap-mcp --client claude

调试方式

  • 确保 API 密钥正确配置
  • 检查 SUBSCRIPTION_LEVEL 是否与你的订阅级别匹配
  • 使用 keyInfo 端点检查 API 密钥的使用情况和状态

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。