返回市场
币市资本-MCP

币市资本-MCP

作者:shinzo-labs41 星标更新:2025-07-24

项目介绍

<div align="center"> <h1 align="center">CoinMarketCap MCP 服务器</h1> <p align=center> <a href="https://badge.fury.io/js/@shinzolabs%2Fcoinmarketcap-mcp"><img src="https://badge.fury.io/js/@shinzolabs%2Fcoinmarketcap-mcp.svg" alt="NPM 版本"></a> <a href="https://github.com/shinzo-labs/coinmarketcap-mcp/stargazers"><img src="https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fapi.github.com%2Frepos%2Fshinzo-labs%2Fcoinmarketcap-mcp%2Fstargazers&query=%24.length&logo=github&label=stars&color=e3b341" alt="星标数"></a> <a href="https://github.com/shinzo-labs/coinmarketcap-mcp/forks"><img src="https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fapi.github.com%2Frepos%2Fshinzo-labs%2Fcoinmarketcap-mcp%2Fforks&query=%24.length&logo=github&label=forks&color=8957e5" alt="分叉数"></a> <a href="https://smithery.ai/server/@shinzo-labs/coinmarketcap-mcp"><img src="https://smithery.ai/badge/@shinzo-labs/coinmarketcap-mcp" alt="Smithery 调用"></a> <a href="https://www.npmjs.com/package/@shinzolabs/coinmarketcap-mcp"><img src="https://img.shields.io/npm/dm/%40shinzolabs%2Fcoinmarketcap-mcp" alt="NPM 下载量"></a> </div>

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

<p align="center"><img height="512" src=https://gips1.baidu.com/it/u=2601780379,414542034&fm=3081&app=3081&f=GIF?w=838&h=1050></p>

功能

  • 完全覆盖了 CoinMarketCap API
  • 获取最新的加密货币趋势、市场动态和全球市场指标的数据
  • 标准订阅或更高订阅级别的用户可以访问详细的 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_KEYSUBSCRIPTION_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
  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" // 见下文选项
      }
    }
  }
}

配置变量

变量描述必需?默认值
COINMARKETCAP_API_KEY来自 CoinMarketCap.com 的 API 密钥
SUBSCRIPTION_LEVELBasic, Hobbyist, Startup, Standard, Professional, 或 EnterpriseBasic
PORT流传输 HTTP 方法的端口3000
TELEMETRY_ENABLED开启遥测true

支持的工具

订阅级别:Basic(及以上)

加密货币

  • cryptoCurrencyMap: 获取所有加密货币的映射
  • getCryptoMetadata: 获取一个或多个加密货币的元数据
  • allCryptocurrencyListings: 获取最新市场报价,最多 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 会从该服务器收集有限的匿名遥测数据,以帮助改进我们的产品和服务。此过程中不会收集任何个人身份信息。请参阅 隐私政策 以了解更多信息,包括收集的数据类型以及如何选择退出此遥测。

许可证

MIT