CoinGecko API服务器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免费和专业API无缝协作
- 🔙 自动回退：在开发过程中返回到免费的API
- 🔌 RESTful端点：简单直观的API界面
- 🛡️ 稳健的错误处理：详细的错误消息和正确的状态代码
- 🧩 简单设置：通过引导式设置快速安装
- 📝 综合文档：明确的使用说明
设置选项
选项1：使用npx（推荐）
这是最快的开始方式：
npx coingecko-api-server交互式设置将：
- 询问服务器的安装位置
- 克隆存储库
- 安装依赖项
- 提示输入CoinGecko API密钥（可选）
- 配置服务器端口
选项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等人工智能系统兼容的MCP（市场组件程序）服务器。要在Claude Desktop中使用此服务器，请执行以下操作：
- 本地启动CoinGecko API服务器
- 在Claude Desktop中通过提供服务器URL来安装MCP（例如。，
http://localhost:3000) - Claude现在可以通过MCP接口访问加密货币数据
服务器使用JSON-RPC 2.0实现了完整的MCP规范：
- JSON-RPC 2.0端点:
/rpc-处理来自AI客户端的所有方法调用 - 架构定义:
/mcp/schema-定义可用的工具和参数 - 标准化沟通：遵循MCP协议，实现无缝AI集成
有关详细的集成说明，请参阅 MCP_INTEGRATION.md.
亲API vs免费API
此服务器同时支持CoinGecko Pro API和免费的API：
- 专业API：更高的速率限制、无限制、额外的端点。需要API密钥。
- 免费API：限制为每分钟约30次通话，可能存在速率限制。
服务器自动检测是否提供了API密钥，并使用适当的API。如果没有提供密钥，它将回到免费的API，这是开发或个人使用的理想选择。
有关Pro API设置的更多详细信息，请参阅 使用_COINGECKO_PRO.md.
发展
# Run in development mode with hot reload
npm run dev服务器使用对CoinGecko API的直接获取调用，确保与免费版和专业版的兼容性。
许可证
此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。
致谢
- CoinGecko 的 用于加密货币数据API
- Anthropic Claude AI和MCP项目