CoinGecko API Server MCP

CoinGecko API Server MCP

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

快速开始

# Install and run with npx
npx coingecko-api-server

# Or clone and install manually
git clone https://github.com/GaplyDev01/coingecko-api-server.git
cd coingecko-api-server
npm install
npm run setup
npm start

功能

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

设置选项

选项 1：使用 npx（推荐）

这是最快的入门方式：

npx coingecko-api-server

交互式设置将会：

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

选项 2：手动设置

如果你更喜欢手动设置：

# Clone the repository
git clone https://github.com/GaplyDev01/coingecko-api-server.git
cd coingecko-api-server

# Install dependencies
npm install

# Run the setup script
npm run setup

# Start the server
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 - 获取支持的计价货币列表

币种数据

• 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 集成信息

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

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

此服务通过 JSON-RPC 2.0 实现了完整的 MCP 规范：

• JSON-RPC 2.0 端点：/rpc - 处理来自 AI 客户端的所有方法调用
• 架构定义：/mcp/schema - 定义可用工具及其参数
• 标准化通信：遵循 MCP 协议，实现无缝 AI 集成

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

Pro API 与免费 API

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

• Pro API：更高的速率限制、不会被限流，并提供更多端点。需要 API 密钥。
• 免费 API：限制为每分钟约 30 次调用，并可能受到速率限制。

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

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

开发

# Run in development mode with hot reload
npm run dev

此服务直接调用 CoinGecko API 的 fetch 方法，确保与免费版和 Pro 版兼容。

许可证

本项目采用 MIT 许可证，详情请参阅 LICENSE 文件。

致谢

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