CoinGecko API 服务器 MCP

一个强大且灵活的 Node.js Express 服务器，提供了一个全面的 CoinGecko 加密货币数据 API 接口。 该服务器支持免费的公共 API 和 Pro API，并具有自动回退功能。

快速开始

# 使用 npx 安装并运行
npx coingecko-api-server

# 或者克隆并手动安装
git clone https://github.com/GaplyDev01/coingecko-api-server.git
cd coingecko-api-server
npm install
npm run setup
npm start

功能特性

• 🔄 双 API 支持: 无缝支持 CoinGecko 免费和 Pro API
• 🔙 自动回退: 开发期间回退到免费 API
• 🔌 RESTful 接口: 简单直观的 API 接口
• 🛡️ 强大的错误处理: 详细的错误消息和正确的状态代码
• 🧩 简单设置: 通过引导式设置快速安装
• 📝 全面的文档: 清晰的使用说明

设置选项

选项 1：使用 npx (推荐)

这是最快的入门方式：

npx coingecko-api-server

交互式设置将：

1. 询问服务器的安装位置
2. 克隆存储库
3. 安装依赖项
4. 提示输入您的 CoinGecko API 密钥（可选）
5. 配置您的服务器端口

选项 2：手动设置

如果您喜欢手动设置：

# 克隆存储库
git clone https://github.com/GaplyDev01/coingecko-api-server.git
cd coingecko-api-server

# 安装依赖项
npm install

# 运行设置脚本
npm run setup

# 启动服务器
npm start

配置

可以使用 .env 文件中的环境变量配置服务器：

变量	描述	默认值
PORT	服务器监听的端口	3000
COINGECKO_API_KEY	您的 CoinGecko Pro API 密钥	-

API 接口

该服务器提供对所有基本 CoinGecko API 接口的访问：

基本接口

• GET /api/ping - 检查 CoinGecko API 状态

价格数据

• GET /api/simple/price - 获取指定币种的价格数据

  • 查询参数: ids, vs_currencies, include_market_cap, include_24hr_vol, include_24hr_change, include_last_updated_at, precision

• GET /api/simple/supported_vs_currencies - 获取支持的 vs 货币列表

币种数据

• GET /api/coins/markets - 获取币种的市场数据
  • 查询参数: vs_currency, ids, category, order, per_page, page, sparkline, price_change_percentage

市场数据

• GET /api/global - 获取全球加密货币数据
• GET /api/search/trending - 获取热门币种

完整的 API 文档可以在 CoinGecko API Documentation 中找到。

MCP 集成信息

这是一个与 Claude 等 AI 系统兼容的 MCP (Marketplace Component Program) 服务器。 要在 Claude Desktop 中使用此服务器：

1. 在本地启动 CoinGecko API 服务器
2. 在 Claude Desktop 中，通过提供服务器 URL（例如，http://localhost:3000）来安装 MCP
3. Claude 现在可以通过 MCP 接口访问加密货币数据

该服务器使用 JSON-RPC 2.0 实现了完整的 MCP 规范：

• JSON-RPC 2.0 接口: /rpc - 处理来自 AI 客户端的所有方法调用
• Schema 定义: /mcp/schema - 定义可用的工具和参数
• 标准化通信: 遵循 MCP 协议以实现无缝 AI 集成

有关详细的集成说明，请参阅 MCP_INTEGRATION.md。

Pro API vs 免费 API

该服务器同时支持 CoinGecko Pro API 和免费 API：

• Pro API: 更高的速率限制，没有限制，额外的接口。 需要 API 密钥。
• 免费 API: 限制为约 30 次调用/分钟，并可能受到速率限制。

服务器会自动检测是否提供了 API 密钥，并使用相应的 API。 如果未提供密钥，它将回退到免费 API，这非常适合开发或个人使用。

有关 Pro API 设置的更多详细信息，请参阅 USING_COINGECKO_PRO.md。

开发

# 在开发模式下运行，并启用热重载
npm run dev

该服务器使用直接的 fetch 调用 CoinGecko API，确保与免费和 Pro 版本兼容。

许可证

该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅 LICENSE 文件。

鸣谢

• CoinGecko 提供加密货币数据 API
• Anthropic 提供 Claude AI 和 MCP 程序