cmc-mcp

CoinMarketCap MCP 技能

你可以通过 MCP 工具访问 CoinMarketCap 数据。使用这些工具，为加密货币相关问题提供全面、数据丰富的回答。

前提条件

使用 CMC 工具前，请确认 MCP 连接正常。如果工具失败或返回连接错误，请让用户设置 MCP 连接：

{
  "mcpServers": {
    "cmc-mcp": {
      "url": "https://mcp.coinmarketcap.com/mcp",
      "headers": {
        "X-CMC-MCP-API-KEY": "your-api-key"
      }
    }
  }
}

在 https://pro.coinmarketcap.com/login 获取 API 密钥

核心原则

尽量多获取数据。使用多个工具给出完整回答，胜过只提供部分信息，导致用户不得不追问。如有疑问，请调用其他工具来收集全面的数据。

工作流

1. 始终先搜索

用户提到加密货币的名称或代号时，先搜索以获取 ID：

User: "How is Solana doing?"
→ Call search_cryptos with query "solana"
→ Get ID (e.g., 5426)
→ Then call other tools using that ID

大多数工具需要的是数字形式的 CMC ID，而不是名称或代号。搜索工具会返回：id、名称、代号、slug 和排名。

2. 适时批量请求

涉及多种加密货币时，批量发送请求：

User: "Compare BTC, ETH, and SOL"
→ Search for each to get IDs: 1, 1027, 5426
→ Call get_crypto_quotes_latest with id="1,1027,5426"

这比单独调用更高效，也便于直接在回答中进行比较。

3. 根据查询类型选择工具

查询价格和市场数据：

• get_crypto_quotes_latest 会返回价格、市值、交易量、涨跌幅（1h、24h、7d、30d、90d、1y）、流通供应量和市场占比

查询加密货币背景信息和链接：

• get_crypto_info 会返回描述、网站、社交媒体链接、区块浏览器 URL、标签和发行日期

进行技术分析：

• get_crypto_technical_analysis 会返回移动平均线（SMA、EMA）、MACD、RSI、斐波那契水平和枢轴点

查询近期新闻：

• get_crypto_latest_news 会返回标题、描述、内容、URL 和发布日期

查询持有者和分布数据：

• get_crypto_metrics 会返回按持有价值划分的地址数量、巨鲸与其他持有者的分布，以及持有者时间细分（交易者、长期持有者、持有者）

解释概念：

• search_crypto_info 会对加密货币概念、白皮书和常见问题执行语义搜索

了解整体市场状况：

• get_global_metrics_latest 会返回总市值、恐惧与贪婪指数、山寨币季节指数、BTC/ETH 市场占比、交易量和 ETF 资金流

查询衍生品和杠杆数据：

• get_global_crypto_derivatives_metrics 会返回未平仓合约量、资金费率、强平数据，以及期货与永续合约细分数据

对总市值进行技术分析：

• get_crypto_marketcap_technical_analysis 会返回整个加密货币市场总市值的 TA 指标

了解热门主题：

• trending_crypto_narratives 会返回热门叙事及其市值、交易量、表现和各叙事中的热门加密货币

查询即将发生的重要事件：

• get_upcoming_macro_events 会返回已安排的事件，例如美联储会议、监管截止日期和重大公告

错误处理

如果搜索没有结果：

1. 告知用户未找到该加密货币
2. 请用户 уточ уточ不中返
3. 如果查询可能存在歧义，提供其他可能的选项

如果工具失败或超时：

1. 对暂时性错误重试一次
2. 如果仍然失败，说明哪些数据不可用，并继续使用其他工具
3. 对于价格查询，get_crypto_quotes_latest 至关重要。如果重试后仍然失败，请告知用户数据暂时不可用。
4. 对于背景信息查询，如果 get_crypto_info 失败，请注明“项目信息不可用”，并根据其他工具尽可能提供信息

如果受到速率限制（429 错误）：

1. 告知用户 API 受到速率限制
2. 建议稍等片刻后重试
3. 考虑减少工具调用次数是否仍能回答问题

根据用户的专业程度调整回答

根据用户查询中的上下文线索判断其专业程度：

• 对于随意提问（“比特币最近表现怎么样？”），提供包含关键数字的清晰摘要
• 对于技术性问题（“BTC 的 RSI 是多少？”），可以提供更详细的数据
• 对于宽泛问题（“加密货币市场现在是什么情况？”），可使用整体市场指标和热门叙事等市场范围工具