Coingecko MCP Server

🚀 CoinGecko API 服務器 MCP

這是一個強大且靈活的 Node.js Express 服務器，為 CoinGecko 加密貨幣數據 API 提供了全面的接口。該服務器支持免費公共 API 和 Pro API，並具備自動回退功能，能為用戶提供穩定、便捷的服務。

🚀 快速開始

你可以選擇以下兩種方式來快速啟動服務器：

# 使用 npx 安裝並運行
npx coingecko-api-server

# 或者克隆並手動安裝
git clone https://github.com/GaplyDev01/coingecko-api-server.git
cd coingecko-api-server
npm install
npm run setup
npm start

✨ 主要特性

• 🔄 雙 API 支持：無縫支持 CoinGecko 免費和 Pro API，滿足不同用戶的需求。
• 🔙 自動回退：在開發期間，若 Pro API 不可用，可自動回退到免費 API，確保服務的連續性。
• 🔌 RESTful 端點：提供簡單直觀的 API 接口，方便用戶調用。
• 🛡️ 強大的錯誤處理：返回詳細的錯誤消息和正確的狀態碼，幫助用戶快速定位和解決問題。
• 🧩 簡單的設置：支持快速安裝，並帶有引導式設置，降低使用門檻。
• 📝 全面的文檔：提供清晰的使用說明，讓用戶能夠輕鬆上手。

📦 安裝指南

選項 1：使用 npx（推薦）

這是最快的安裝方式：

npx coingecko-api-server

交互式設置流程如下：

1. 詢問安裝服務器的位置。
2. 克隆倉庫。
3. 安裝依賴項。
4. 提示輸入你的 CoinGecko API 密鑰（可選）。
5. 配置你的服務器端口。

選項 2：手動設置

如果你更喜歡手動設置，可以按以下步驟操作：

# 克隆倉庫
git clone https://github.com/GaplyDev01/coingecko-api-server.git
cd coingecko-api-server

# 安裝依賴項
npm install

# 運行設置腳本
npm run setup

# 啟動服務器
npm start

📚 詳細文檔

配置

服務器可以通過 .env 文件中的環境變量進行配置：

API 端點

服務器提供了對所有必要的 CoinGecko API 端點的訪問：

基本端點

• GET /api/ping - 檢查 CoinGecko API 狀態

價格數據

• GET /api/simple/price - 獲取指定硬幣的價格數據

  • 查詢參數：ids，vs_currencies，include_market_cap，include_24hr_vol，include_24hr_change，include_last_updated_at，precision

• GET /api/simple/supported_vs_currencies - 獲取支持的 vs 貨幣列表

硬幣數據

• GET /api/coins/markets - 獲取硬幣市場數據
  • 查詢參數：vs_currency，ids，category，order，per_page，page，sparkline，price_change_percentage

市場數據

• GET /api/global - 獲取全球加密貨幣數據
• GET /api/search/trending - 獲取趨勢幣

完整的 API 文檔可以在 CoinGecko API 文檔 中找到。

MCP 集成信息

這是一個與 AI 系統（如 Claude）兼容的 MCP（市場組件計劃）服務器。要在 Claude Desktop 中使用此服務器：

1. 在本地啟動 CoinGecko API 服務器。
2. 在 Claude Desktop 中，通過提供服務器 URL（例如 http://localhost:3000）安裝 MCP。
3. Claude 現在可以通過 MCP 接口訪問數據。

# 以開發模式運行，帶有熱重載
npm run dev

該服務器使用直接的 fetch 調用訪問 CoinGecko API，確保與免費和 Pro 版本兼容。

📄 許可證

該項目根據 MIT 許可證進行許可 - 有關詳細信息，請參閱 LICENSE 文件。

致謝

• CoinGecko 提供了加密貨幣數據 API。
• Anthropic 提供了 Claude AI 和 MCP 計劃。