remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Offers access to Bitcoin price data, market information, and other cryptocurrency metrics through the CoinGecko API
Utilizes Express framework to expose a RESTful API for cryptocurrency data access
Built on Node.js to provide a server platform for cryptocurrency data access

🚀 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 程序的人类学
开源社区的宝贵贡献

⬆ 返回顶部

由 [您的组织] 倾情打造

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

一个强大而灵活的 Node.js Express 服务器，提供全面的 CoinGecko 加密货币数据 API 接口。该服务器同时支持免费的公共 API 和 Pro API，并具有自动回退功能。

Related Resources

Reddit Discussion about this server