coingecko-mcp-server

CoinGecko MCP 服务

一个用于 CoinGecko 的 MCP 服务——让任何兼容 MCP 的客户端都能连接免费的加密货币市场数据。

这是什么？

这是一个 MCP（Model Context Protocol） 服务，可让 AI 助手和 Agent 通过自然语言访问 CoinGecko 的免费加密货币市场数据 API，包括价格、市值、热门币种、历史数据和全球统计数据。

可将它与 Claude Desktop、Cursor、Windsurf、Cline、Continue 或任何兼容 MCP 的客户端搭配使用，以询问加密货币市场相关问题、比较代币并追踪价格。

为什么使用它？

• 无需 API 密钥——CoinGecko 免费套餐开箱即用（速率限制约为每分钟 27 次调用）
• 内置 8 个工具——涵盖最常见的加密货币数据查询
• 输出整洁的 Markdown——结果在聊天中读起来自然
• 自动限制速率——遵循免费套餐限制，并在遇到 429 错误时重试

工具

工具	描述
search_coins	按名称或代币符号搜索加密货币
get_prices	获取一个或多个币种的当前价格、市值和 24 小时变化
get_market_overview	获取市值排名前 N 的币种及完整统计数据
get_trending	获取当前热门币种（过去 24 小时的搜索量）
get_coin_details	获取特定币种的详细信息（描述、链接、市场数据、类别）
get_price_history	获取历史价格数据（日、周、月、年）
get_global_stats	获取全球加密货币市场统计数据（总市值、BTC 主导率、活跃加密货币数量）
get_token_price_comparison	并排比较多个代币的价格和统计数据

快速开始

1. 添加到 MCP 客户端

将以下内容添加到 MCP 客户端配置中（例如 claude_desktop_config.json）：

{
  "mcpServers": {
    "coingecko": {
      "command": "npx",
      "args": ["-y", "coingecko-mcp-server"]
    }
  }
}

完成。无需 API 密钥，也无需安装步骤。npx 会自动下载并运行它。

2. 使用

可以向 AI 助手提出如下问题：

• “Bitcoin 和 Ethereum 当前的价格是多少？”
• “列出市值排名前 10 的币种”
• “CoinGecko 现在有哪些热门币种？”
• “比较 Solana、Avalanche 和 Polkadot”
• “过去 30 天 Bitcoin 的表现如何？”
• “加密货币市场总市值和 BTC 主导率是多少？”
• “搜索与 AI 相关的加密代币”
• “介绍一下 Chainlink——类别、链接和市场数据”

输出示例

get_trending

🔥 Trending Coins (last 24h):

1. Bitcoin (BTC) — Rank #1 | MCap: $1,340.2B | 24h: +2.1%
2. Ethereum (ETH) — Rank #2 | MCap: $412.8B | 24h: +1.8%
3. Solana (SOL) — Rank #5 | MCap: $78.4B | 24h: +4.3%
...

get_token_price_comparison

Token Comparison (USD):

| Coin | Price | MCap | 24h | 7d | Vol |
|------|-------|------|-----|-----|-----|
| Bitcoin (BTC) | $67,234 | $1,340.2B | +2.1% | +5.3% | $28,400M |
| Ethereum (ETH) | $3,456 | $412.8B | +1.8% | +3.1% | $14,200M |
| Solana (SOL) | $178.5 | $78.4B | +4.3% | +12.1% | $3,800M |

使用场景

投资组合研究

列出持仓后，询问“我的投资组合值多少钱？”。服务会比较多个代币的价格，并提供包含市值、24 小时变化和交易量的概览。

流动性挖矿研究

“列出交易量高的热门币种”——查看哪些币种受到关注，寻找新的机会。还可以结合 get_coin_details 深入了解类别和链接，再决定是否投入。

市场情报

询问“加密货币市场总市值和 BTC 主导率是多少？”，几秒钟内即可了解宏观市场情况。做出任何资产配置决策前，都可以使用 get_global_stats。

代币比较

“比较 Solana、Avalanche 和 Polkadot”——并排查看价格、市值和表现数据。比打开 CoinGecko 的三个标签页更快。

历史分析

“Bitcoin 过去 30 天的表现如何？”——获取每日价格历史记录以分析趋势。适用于任何时间范围（每日、每周、每月、每年）。

安全性

• 默认无需 API 密钥——使用 CoinGecko 免费版。可选用 API 密钥提高速率限制。
• 只读——仅从 CoinGecko 的 API 获取公开市场数据。不执行写入或修改操作。
• 不访问本地文件——不会读取或写入你计算机上的任何文件。
• 不访问 Shell——不会执行命令或启动进程。
• 限制速率——自动限制请求，以符合免费版的限制。
• 开源——采用 MIT 许可证。可在 GitHub 查看代码。

故障排除

速率限制错误（429）

服务会在遇到 429 错误时自动重试，但如果你频繁发起查询，请在请求之间稍作间隔。免费版每分钟允许约 27 次调用。如果经常遇到此问题，请设置 COINGECKO_API_KEY 以提高限制。

“找不到币种”错误

先使用 search_coins 查找正确的 CoinGecko ID。币种 ID 是小写的名称标识（例如 bitcoin、ethereum、solana），而非代码。

服务无法启动

确保已安装 Node.js 18+：node --version。如果使用 npx，请确保 npm 是最新版本：npm install -g npm@latest。

MCP 客户端无法连接

确认配置路径正确。Claude Desktop 在 macOS 上使用 ~/Library/Application Support/Claude/claude_desktop_config.json，在 Windows 上使用 %APPDATA%\Claude\claude_desktop_config.json。更改配置后，请重启客户端。

响应缓慢

CoinGecko 免费版每次调用的延迟约为 300 毫秒。多币种查询（get_prices、get_token_price_comparison）无论传入多少种币，都只会发起一次 API 调用，因此请批量进行查询。

要求

• Node.js 18+
• 无需 API 密钥（CoinGecko 免费版）

速率限制

服务会自动将请求速率限制在每分钟约 27 次调用，以符合 CoinGecko 免费版的限制。如果你有 CoinGecko Pro API 密钥，可以设置 COINGECKO_API_KEY 环境变量以提高限制：

{
  "mcpServers": {
    "coingecko": {
      "command": "coingecko-mcp-server",
      "env": {
        "COINGECKO_API_KEY": "your_key_here"
      }
    }
  }
}

开发

git clone https://github.com/nova/coingecko-mcp-server.git
cd coingecko-mcp-server
npm install
npm run build
npm start

许可证

MIT