🚀 CoinGecko API Server MCP

<div align="center">

为AI系统和应用程序提供无缝的加密货币数据访问

功能 • 快速开始 • 安装 • 配置 • API参考 • MCP集成 • 专业API • 故障排除 • 许可证

</div>

🌟 概述

CoinGecko API Server MCP 是一个强大的、生产就绪的 Node.js 解决方案，通过优雅的 RESTful API 和 MCP（市场组件程序）接口提供对加密货币市场数据的无缝访问。它连接像 Claude 这样的AI系统与实时加密货币数据，同时处理所有API速率限制、回退和错误处理的复杂性。

<div align="center"> <img src="https://www.coingecko.com/assets/coingecko-logo-white-ea42ded10e4d604886deac6b8449b2b2230a0df0d0c6edd2c3b4587da9038cff.png" alt="CoinGecko Logo" width="300"/> </div>

✨ 关键特性

• 🔄 双重API支持：无缝集成CoinGecko免费和专业API
• 🧠 AI集成：完全实现MCP协议用于AI助手
• 🛡️ 智能回退：自动在API之间切换以防止速率限制
• ⚡ 优化性能：高效请求处理和响应缓存
• 📊 全面数据：访问所有重要的加密货币指标
• 🔌 简单接口：直观的RESTful端点和JSON-RPC方法
• 🚦 坚固的错误处理：带有适当状态码的清晰错误消息
• 🧩 易于部署：最小配置和引导设置过程
• 📘 详尽文档：清晰的使用说明和示例

🚀 快速开始

# 选项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

📦 安装

选项1：使用npx（推荐）

最快的方式开始：

npx coingecko-api-server

这将：

1. 📥 下载并安装服务器
2. 🧰 运行交互式设置向导
3. 🔑 请求您的CoinGecko API密钥（可选）
4. 🚀 自动启动服务器

选项2：手动安装

对于更控制的安装过程：

# 克隆仓库
git clone https://github.com/yourusername/coingecko-api-server.git
cd coingecko-api-server

# 安装依赖
npm install

# 运行设置脚本
npm run setup

# 启动服务器
npm start

⚙️ 配置

服务器通过.env文件中的环境变量进行配置：

变量	描述	默认值
PORT	服务器端口	3000
COINGECKO_API_KEY	CoinGecko专业API密钥（可选）	-
CACHE_DURATION	缓存持续时间（秒）	60
LOG_LEVEL	日志级别（error, warn, info, debug）	info

📚 API参考

RESTful端点

基础端点

• GET /api/ping - 检查API服务器状态

价格数据

• GET /api/simple/price - 获取指定加密货币的价格数据
  • 查询参数：ids, vs_currencies, include_market_cap, include_24hr_vol, include_24hr_change, include_last_updated_at, precision

加密货币数据

• GET /api/coins/markets - 获取加密货币的市场数据
  • 查询参数：vs_currency, ids, category, order, per_page, page, sparkline, price_change_percentage

市场数据

• GET /api/global - 获取全球加密货币数据
• GET /api/search/trending - 获取热门加密货币

示例

获取比特币的美元价格：

curl "http://localhost:3000/api/simple/price?ids=bitcoin&vs_currencies=usd"

响应：

{
  "bitcoin": {
    "usd": 45678.12
  }
}

获取按市值排名前五的加密货币：

curl "http://localhost:3000/api/coins/markets?vs_currency=usd&order=market_cap_desc&per_page=5&page=1"

🤖 AI集成（MCP）

此服务器实现了Marketplace Component Program（MCP）协议，使像Claude这样的AI系统能够访问加密货币数据。

MCP集成点

1. JSON-RPC端点：/rpc - 处理来自AI客户端的方法调用
2. 模式定义：/mcp/schema - 定义可用工具和参数

可用的MCP方法

• ping - 检查API状态
• getPrice - 获取指定加密货币的价格数据
• getSupportedVsCurrencies - 获取支持的货币列表
• getCoinMarkets - 获取加密货币的市场数据
• getGlobal - 获取全球加密货币数据
• getTrending - 获取热门加密货币

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

💎 专业API优势

此服务器支持CoinGecko专业API和免费API：

特性	免费API	专业API
速率限制	~30次/分钟	~500次/分钟
API节流	是	否
支持	社区	优先
数据新鲜度	10-30分钟	1-2分钟
价格	免费	订阅

有关专业API设置的更多详细信息，请参阅USING_COINGECKO_PRO.md。

🔧 故障排除

问题	解决方案
速率限制错误	考虑升级到专业API或调整请求频率
连接被拒绝	确保服务器正在指定端口上运行
认证错误	检查.env文件中的API密钥
缺失数据	验证请求中的参数

🧪 开发

# 在开发模式下运行，具有热重载
npm run dev

# 运行测试
npm test

# 构建生产环境
npm run build

🔄 工作原理

服务器作为中间件位于您的应用程序和CoinGecko API之间：

1. 请求路由：处理来自RESTful和JSON-RPC客户端的传入请求
2. API选择：根据配置在免费和专业API之间选择
3. 速率限制管理：实现智能请求节流
4. 响应处理：格式化并返回一致结构的数据
5. 错误处理：提供详细的错误信息以便于故障排除

📱 使用案例

• AI驱动的财务顾问：使AI系统能够访问实时加密货币数据
• 投资仪表板：构建具有可靠数据访问的加密货币仪表板
• 投资组合追踪器：创建应用来监控加密货币持有
• 市场分析工具：开发用于技术和基本面分析的工具
• 交易机器人：用市场数据驱动自动化交易系统

📄 许可证

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

🙏 致谢

• CoinGecko 提供全面的加密货币数据API
• Anthropic 提供Claude AI和MCP计划
• 开源社区对其宝贵的贡献

---

<div align="center">

⬆ 返回顶部

</div>