Gaplydev01 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。
• 🔙 自動回退：在開發期間能自動回退到免費 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 現在可以訪問與免費和 Pro 版本都兼容的 API。

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

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

📄 許可證

此項目根據 MIT 許可證發佈 - 有關詳細信息，請參閱 LICENSE 文件。

致謝

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