CoinGecko API Server 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 - 获取支持的对比货币列表

硬币数据

• 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桌面中使用此服务器：

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

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

• JSON-RPC 2.0端点：/rpc - 处理来自AI客户端的所有方法调用
• 模式定义：/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

服务器直接调用CoinGecko API，确保与免费版和Pro版都兼容。

许可证

本项目采用MIT许可证 - 详情见LICENSE文件。

致谢

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