🚀 CoinGecko API 服务器 MCP

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

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

🌟 概述

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

Related MCP server: CoinGecko API Server MCP

✨ 主要特点

• 🔄 双 API 支持：与 CoinGecko Free 和 Pro API 无缝集成

• 🧠 AI 集成：全面实现 AI 助手的 MCP 协议

• 🛡️ 智能回退：自动在 API 之间切换以防止速率限制

• ⚡ 优化性能：高效的请求处理和响应缓存

• 📊 综合数据：访问所有必要的加密货币指标

• 🔌 简单的界面：直观的 RESTful 端点和 JSON-RPC 方法

• 🚦强大的错误处理：使用适当的状态代码清除错误消息

• 🧩 轻松部署：最低配置，引导式设置流程

• 📘 详尽的文档：清晰的使用说明和示例

🚀 快速入门

📦安装

选项 1：使用 npx（推荐）

最快捷的入门方式：

这将：

1. 📥 下载并安装服务器

2. 🧰 运行交互式设置向导

3. 🔑 索取您的 CoinGecko API 密钥（可选）

4. 🚀 自动启动服务器

选项 2：手动安装

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

⚙️ 配置

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

📚 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 - 获取热门币种

示例

获取比特币美元价格：

回复：

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

🤖 人工智能集成（MCP）

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

MCP 集成点

1. JSON-RPC 端点： /rpc - 处理来自 AI 客户端的方法调用

2. 模式定义： /mcp/schema - 定义可用的工具和参数

可用的 MCP 方法

• ping - 检查 API 状态

• getPrice - 获取指定加密货币的价格数据

• getSupportedVsCurrencies - 获取支持的货币列表

• getCoinMarkets - 获取硬币市场数据

• getGlobal - 获取全球加密货币数据

• getTrending - 获取热门币种

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

💎 Pro API 优势

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

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

🔧 故障排除

🧪 开发

🔄 工作原理

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

1. 请求路由：处理来自 RESTful 和 JSON-RPC 客户端的传入请求

2. API 选择：根据配置在免费版和专业版 API 之间进行选择

3. 速率限制管理：实现智能请求限制

4. 响应处理：以一致的结构格式化并返回数据

5. 错误处理：提供详细的错误信息以便排除故障

📱 用例

• 人工智能金融顾问：使人工智能系统能够访问实时加密数据

• 投资仪表板：构建具有可靠数据访问的加密货币仪表板

• 投资组合追踪器：创建应用程序来监控加密货币持有量

• 市场分析工具：开发技术和基本面分析工具

• 交易机器人：利用市场数据为自动交易系统提供动力

📄 许可证

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

🙏 致谢

• CoinGecko提供全面的加密货币数据 API

• 克劳德人工智能和 MCP 程序的人类学

• 开源社区的宝贵贡献

⬆ 返回顶部

由 [您的组织] 倾情打造