CoinGecko

🚀 CoinGecko API 服务器 MCP

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

功能•快速入门•安装•配置• API 参考• MCP 集成• Pro API •故障排除•许可证

🌟 概述

CoinGecko API 服务器 MCP 是一款功能强大、可立即投入生产的 Node.js 解决方案，它通过简洁的 RESTful API 和 MCP（市场组件程序）接口，无缝访问加密货币市场数据。它连接了 Claude 等 AI 系统与实时加密数据，同时还能处理 API 速率限制、回退和错误处理等所有复杂问题。

✨ 主要特点

🔄 双 API 支持：与 CoinGecko Free 和 Pro API 无缝集成
🧠 AI 集成：全面实现 AI 助手的 MCP 协议
🛡️ 智能回退：自动在 API 之间切换以防止速率限制
⚡ 优化性能：高效的请求处理和响应缓存
📊 综合数据：访问所有必要的加密货币指标
🔌 简单的界面：直观的 RESTful 端点和 JSON-RPC 方法
🚦强大的错误处理：使用适当的状态代码清除错误消息
🧩 轻松部署：最低配置，引导式设置流程
📘 详尽的文档：清晰的使用说明和示例

🚀 快速入门

# Option 1: Install and run with npx
npx coingecko-api-server

# Option 2: Clone and install manually
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

这将：

📥 下载并安装服务器
🧰 运行交互式设置向导
🔑 索取您的 CoinGecko API 密钥（可选）
🚀 自动启动服务器

选项 2：手动安装

为了更好地控制安装过程：

# Clone the repository
git clone https://github.com/yourusername/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 密钥（可选）	-
`CACHE_DURATION`	缓存持续时间（秒）	`60`
`LOG_LEVEL`	日志级别（错误、警告、信息、调试）	`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
  }
}

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

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

🤖 人工智能集成（MCP）

该服务器实现了市场组件程序 (MCP) 协议，使 Claude 等人工智能系统能够访问加密货币数据。

MCP 集成点

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

可用的 MCP 方法

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

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

💎 Pro API 优势

该服务器同时支持 CoinGecko Pro API 和免费 API：

特征	免费 API	专业 API
速率限制	~30 个呼叫/分钟	~500 个呼叫/分钟
API 限制	是的	不
支持	社区	优先事项
数据新鲜度	10-30分钟	1-2分钟
价格	自由的	订阅

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

🔧 故障排除

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

🧪 开发

# Run in development mode with hot reload
npm run dev

# Run tests
npm test

# Build for production
npm run build

🔄 工作原理

服务器充当您的应用程序和 CoinGecko API 之间的中间件：

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

📱 用例

人工智能金融顾问：使人工智能系统能够访问实时加密数据
投资仪表板：构建具有可靠数据访问的加密货币仪表板
投资组合追踪器：创建应用程序来监控加密货币持有量
市场分析工具：开发技术和基本面分析工具
交易机器人：利用市场数据为自动交易系统提供动力

📄 许可证

该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅LICENSE文件。

🙏 致谢

CoinGecko提供全面的加密货币数据 API
克劳德人工智能和 MCP 程序的人类学
开源社区的宝贵贡献

⬆ 返回顶部

由 [您的组织] 倾情打造