Gaplydev01 Coingecko MCP Server

🚀 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 现在可以访问与免费和 Pro 版本都兼容的 API。

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

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

📄 许可证

此项目根据 MIT 许可证发布 - 有关详细信息，请参阅 LICENSE 文件。

致谢

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