
🚀 CoinGecko API Server MCP

2025.03.21
3
JavaScript加密货币数据API 服务AI 集成金融服务
CoinGecko API Server MCP 是一个基于 Node.js 的解决方案,提供对加密货币市场数据的无缝访问。它通过 RESTful API 和 MCP(Marketplace Component Program)接口,为 AI 系统和应用程序提供实时加密货币数据,同时处理 API 速率限制、回退和错误处理等复杂问题。
View on GitHub
Overview
🌟 产品定位
CoinGecko API Server MCP 是一个强大的、生产就绪的 Node.js 解决方案,为 AI 系统和应用程序提供无缝的加密货币市场数据访问。
✨ 核心功能
- 🔄 双 API 支持:无缝集成 CoinGecko 免费和 Pro API
- 🧠 AI 集成:完整实现 MCP 协议,供 AI 助手使用
- 🛡️ 智能回退:自动切换 API 以防止速率限制
- ⚡ 优化性能:高效的请求处理和响应缓存
- 📊 全面数据:访问所有基本加密货币指标
- 🔌 简单接口:直观的 RESTful 端点和 JSON-RPC 方法
- 🚦 健壮的错误处理:清晰的错误消息和适当的状态码
- 🧩 易于部署:最小化配置,带有引导设置过程
- 📘 详细文档:清晰的使用说明和示例
🚀 适用场景
- AI 驱动的金融顾问:使 AI 系统能够访问实时加密货币数据
- 投资仪表板:构建具有可靠数据访问的加密货币仪表板
- 投资组合跟踪器:创建监控加密货币持仓的应用程序
- 市场分析工具:开发技术和基本面分析工具
- 交易机器人:为自动化交易系统提供市场数据
🛠️ 工具列表
MCP 方法
ping
- 检查 API 状态getPrice
- 获取指定加密货币的价格数据getSupportedVsCurrencies
- 获取支持的货币列表getCoinMarkets
- 获取硬币的市场数据getGlobal
- 获取全球加密货币数据getTrending
- 获取趋势硬币
❓ 常见问题解答
问题 | 解决方案 |
---|---|
速率限制错误 | 考虑升级到 Pro API 或调整请求频率 |
连接被拒绝 | 确保服务器在指定端口上运行 |
认证错误 | 检查 .env 文件中的 API 密钥 |
数据缺失 | 验证请求中的参数 |
📦 使用教程
使用依赖
确保已安装 Node.js(版本 ≥ 14.0.0)和 npm。
安装教程
选项 1:使用 npx(推荐)
npx coingecko-api-server
选项 2:手动安装
git clone https://github.com/yourusername/coingecko-api-server.git
cd coingecko-api-server
npm install
npm run setup
npm start
调试方式
# 开发模式运行,带热重载
npm run dev
# 运行测试
npm test
# 生产构建
npm run build