CoinGecko MCP Server

什么是 CoinGecko MCP Server？

CoinGecko MCP Server 是 CoinGecko 官方托管的 MCP 端点，为 AI 助手提供实时和历史加密市场数据。位于 https://mcp.api.coingecko.com/mcp 的这个免费版本无需 API 密钥，也无需登录。

CoinGecko 是规模最大的独立加密数据聚合平台之一，追踪币种、代币、交易所、NFT 以及链上 DEX 资金池。它的 MCP 服务器面向开发者、交易者、分析师，以及所有希望让 Claude、Cursor 等助手用实时数字而不是过时训练数据来回答市场问题的人。

如何使用 CoinGecko MCP Server？

CoinGecko 提供三种 MCP 服务器：

• 免费（无密钥）：https://mcp.api.coingecko.com/mcp。无需认证，使用共享速率限制。本页列出的就是这个端点。
• API 密钥（远程）：https://mcp.pro-api.coingecko.com/mcp。需要 CoinGecko API 密钥，提供更高的限额和完整的工具集。首次连接时会打开浏览器标签页供你输入密钥。
• 本地：npm 包 @coingecko/coingecko-mcp，在你的电脑上使用 Pro 或 Demo 密钥运行。

两个远程服务器也都提供 /sse 端点，但 CoinGecko 文档建议始终优先使用 /mcp。

Claude Code

claude mcp add --transport http coingecko https://mcp.api.coingecko.com/mcp

运行 claude mcp list 确认已连接。如需改用自己的密钥，请改为添加 mcp.pro-api.coingecko.com 的 URL，并在会话中运行 /mcp 完成认证。

Claude Desktop 与 claude.ai

打开 Settings，进入 Connectors，选择「Add custom connector」，名称填 CoinGecko，并粘贴 https://mcp.api.coingecko.com/mcp。无密钥服务器无需其他步骤。CoinGecko 文档还给出了用 npx mcp-remote 包装 URL 的 Claude Desktop 配置，供有需要的环境使用。

Cursor

{
  "mcpServers": {
    "coingecko": {
      "url": "https://mcp.api.coingecko.com/mcp"
    }
  }
}

VS Code

{
  "servers": {
    "coingecko": {
      "type": "http",
      "url": "https://mcp.api.coingecko.com/mcp"
    }
  }
}

CoinGecko MCP Server 的主要功能

• CoinGecko 官方服务器，文档位于 docs.coingecko.com。
• 无密钥的远程端点，无需注册账户，几秒钟即可试用。
• 实时和历史价格、市值与交易量。
• 交易所数据、热门币种、市场分析等市场情报。
• 覆盖多个 DEX 和网络的代币与流动性池链上分析。
• 代码执行式设计：智能体基于官方 CoinGecko SDK 编写简短的 TypeScript，一次调用即可组合多个 API 请求。
• 可升级到限额更高的密钥版服务器，或使用本地 npm 服务器。

CoinGecko MCP Server 工具

无密钥服务器提供两个相互配合的工具：

• 发现：search_docs 搜索 CoinGecko SDK 文档中的方法、参数和用法示例。智能体会先调用它，为问题找到合适的接口。
• 执行：execute 运行定义了异步 run(client) 函数的 JavaScript 或 TypeScript 代码。该函数会收到一个已初始化的 CoinGecko SDK 客户端（例如 client.simple.price.get(...)），工具返回函数的返回值以及所有 console.log 输出。

由于智能体是编写代码，而不是为每个接口调用一个固定工具，它可以一步完成获取、筛选和计算，例如拉取十个币种的价格并按 24 小时涨跌幅排序。

CoinGecko MCP Server 的使用场景

• 快速查价：「比特币和以太坊现在的美元和欧元价格是多少？」
• 市场概览：「给我看看 CoinGecko 上当前最热门的币种。」
• 历史分析：「获取 Solana 过去 90 天的每日收盘价并总结走势。」
• DeFi 研究：「找出这个代币在链上 DEX 中流动性最好的资金池。」
• 开发加密功能：让编程智能体先用 search_docs 了解 CoinGecko SDK，再为你的应用编写集成代码。

CoinGecko MCP Server 常见问题排查

• 速率限制错误：无密钥服务器使用共享速率限制。用量较大时，请改用 https://mcp.pro-api.coingecko.com/mcp 并使用自己的 API 密钥。
• 似乎缺少某个工具或接口：API 密钥版服务器提供完整工具集，包括你的套餐可用的高级接口。
• 客户端不支持 Streamable HTTP：使用 /sse 端点，或 CoinGecko 文档中给出的 mcp-remote 包装方式。
• 用量计入你的套餐：在密钥版服务器上，每次工具调用都可能触发一个或多个 API 请求，这些请求会计入你的速率限制和额度。