🚀 CoinGecko API Server MCP

🚀 CoinGecko API Server MCP

site icon
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

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。