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 文件中的环境变量进行配置：

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 文档 中找到。

MCP 集成信息

这是一个与 AI 系统（如 Claude）兼容的 MCP（市场组件计划）服务器。要在 Claude Desktop 中使用此服务器：

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

# 以开发模式运行，带有热重载
npm run dev

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

许可证

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

致谢

• CoinGecko 提供了加密货币数据 API
• Anthropic 提供了 Claude AI 和 MCP 计划