Coinmarketcap

一个 CoinMarketCap API 的 Model Context Protocol（MCP） 服务实现，提供标准化接口，用于访问加密货币市场数据、交易所信息和其他区块链相关指标。

功能

• 完整覆盖 CoinMarketCap API
• 获取最新加密货币趋势、市场动态和全球市场指标数据
• Standard 订阅或更高级别可访问详细的 OHLCV 数据
• 使用 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

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

NPX 本地安装

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

{
  "mcpServers": {
    "coinmarketcap": {
      "command": "npx",
      "args": [
        "@shinzolabs/coinmarketcap-mcp"
      ],
      "env": {
        "COINMARKETCAP_API_KEY": "your-key-here",
        "SUBSCRIPTION_LEVEL": "Basic" // See options below
      }
    }
  }
}

从源代码构建

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" // See options below
      }
    }
  }
}

配置变量

变量	描述	必填？	默认值
COINMARKETCAP_API_KEY	来自 CoinMarketCap.com 的 API 密钥	是
SUBSCRIPTION_LEVEL	Basic、Hobbyist、Startup、Standard、Professional 或 Enterprise	否	Basic
PORT	Streamable HTTP 传输方式使用的端口	否	3000
TELEMETRY_ENABLED	启用遥测	否	true

支持的工具

订阅级别：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，了解问题反馈、贡献方式和联系信息。

数据收集与隐私

Shinzo Labs 会从此服务收集少量匿名遥测数据，以帮助改进我们的产品和服务。此过程中不会收集任何个人身份信息。请查看 Privacy Policy，了解收集的数据类型以及如何选择退出遥测。

许可证

MIT