CoinMarketCap MCP

这是一个为 CoinMarketCap API 实现的 模型上下文协议 (MCP)，提供了一个标准化的接口来访问加密货币市场数据、交易所信息和其他区块链相关指标。

功能

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

先决条件

如果您没有 API 密钥，请先在此注册以获取免费的 Basic 密钥。

客户端配置

有几种方法可以配置您的 MCP 客户端与服务器连接。对于托管/远程服务器设置，请使用 Smithery 的 CLI 和 Smithery API 密钥。对于本地安装，请使用 npx 或从源代码构建。以下将详细说明这些选项。

Smithery 远程服务器（推荐）

要将远程服务器添加到您的 MCP 客户端 config.json 中，请从 Smithery CLI 运行以下命令：

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

在提示时输入您的 COINMARKETCAP_API_KEY 和 SUBSCRIPTION_LEVEL（见下文选项）。

Smithery SDK

如果您正在开发自己的代理应用程序，可以使用此处的样板代码。

NPX 本地安装

要使用 npx 在本地安装服务器，请将以下内容添加到您的 MCP 客户端 config.json 中：

{
  "mcpServers": {
    "coinmarketcap": {
      "command": "npx",
      "args": [
        "@shinzolabs/coinmarketcap-mcp"
      ],
      "env": {
        "COINMARKETCAP_API_KEY": "your-key-here",
        "SUBSCRIPTION_LEVEL": "Basic" // 见下文选项
      }
    }
  }
}

从源代码构建

1. 下载仓库：

git clone https://github.com/shinzo-labs/coinmarketcap-mcp.git

2. 安装依赖包（在克隆的仓库内）：

pnpm i

3. 将以下内容添加到您的 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（及以上）

加密货币

• cryptoCurrencyMap: 获取所有加密货币的映射
• getCryptoMetadata: 获取一个或多个加密货币的元数据
• allCryptocurrencyListings: 获取 1-5000 个加密货币的最新市场报价
• cryptoQuotesLatest: 获取一个或多个加密货币的最新市场报价
• cryptoCategories: 获取所有加密货币类别的列表
• cryptoCategory: 获取加密货币类别的元数据

交易所

• exchangeMap: 获取所有交易所的映射
• exchangeInfo: 获取一个或多个交易所的元数据
• exchangeAssets: 获取交易所上所有可用资产的列表

DEX

• dexInfo: 获取一个或多个去中心化交易所的元数据
• dexListingsLatest: 获取所有 DEX 的最新市场数据
• dexNetworksList: 获取所有网络的列表及其唯一 ID
• dexSpotPairsLatest: 获取所有活跃 DEX 现货对的最新市场数据
• dexPairsQuotesLatest: 获取现货对的最新市场报价
• dexPairsOhlcvLatest: 获取现货对的最新 OHLCV 数据
• dexPairsOhlcvHistorical: 获取现货对的历史 OHLCV 数据
• dexPairsTradeLatest: 获取现货对的最新交易

全球指标

• globalMetricsLatest: 获取最新的全球加密货币指标

指数

• cmc100IndexLatest: 获取最新的 CoinMarketCap 100 指数值及其成分
• cmc100IndexHistorical: 获取 CoinMarketCap 100 指数的历史值

工具

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

其他

• fiatMap: 获取所有法定货币的映射
• keyInfo: 获取 API 密钥的使用情况和状态
• fearAndGreedLatest: 获取最新的恐惧与贪婪指数
• fearAndGreedHistorical: 获取恐惧与贪婪指数的历史值

订阅级别：Hobbyist（及以上）

加密货币

• cryptoAirdrops: 获取所有加密货币空投的列表
• cryptoAirdrop: 获取特定空投的元数据
• historicalCryptocurrencyListings: 获取任何加密货币的历史市场报价
• cryptoQuotesHistorical: 获取任何加密货币的历史市场报价
• cryptoQuotesHistoricalV3: 获取带有高级时间间隔的历史市场报价

交易所

• exchangeQuotesHistorical: 获取任何交易所的历史报价

全球指标

• globalMetricsHistorical: 获取全球加密货币指标的历史数据

订阅级别：Startup（及以上）

加密货币

• newCryptocurrencyListings: 获取最近添加的加密货币列表
• cryptoTrendingGainersLosers: 获取给定时间段内涨幅和跌幅最大的加密货币
• cryptoTrendingLatest: 获取按搜索量排名的顶级加密货币
• cryptoTrendingMostVisited: 获取访问量最大的加密货币
• cryptoOhlcvLatest: 获取任何加密货币的最新 OHLCV 市场数据
• cryptoOhlcvHistorical: 获取任何加密货币的历史 OHLCV 市场数据
• cryptoPricePerformanceStatsLatest: 获取任何加密货币的价格表现统计数据

订阅级别：Standard（及以上）

加密货币

• cryptoMarketPairsLatest: 获取任何加密货币的最新市场对

交易所

• exchangeListingsLatest: 获取所有交易所的最新市场数据
• exchangeMarketPairsLatest: 获取任何交易所的最新市场对
• exchangeQuotesLatest: 获取一个或多个交易所的最新市场报价

内容

• contentLatest: 获取最新的加密货币新闻和内容
• contentPostsTop: 获取顶级加密货币帖子
• contentPostsLatest: 获取最新的加密货币帖子
• contentPostsComments: 获取特定帖子的评论

社区

• communityTrendingTopic: 获取加密货币社区中的热门话题
• communityTrendingToken: 获取加密货币社区中的热门代币

订阅级别：Enterprise（及以上）

区块链

• blockchainStatisticsLatest: 获取一个或多个区块链的最新统计数据

贡献

欢迎并鼓励贡献！请阅读 CONTRIBUTING.md 了解问题、贡献和联系信息的指南。