MCP Server Coingecko

🚀 加密貨幣市場 MCP 服務器

本項目是一個實現 Model Context Protocol（MCP）協議的服務器，為用戶提供了通過 CoinGecko 訪問加密貨幣市場數據的便捷工具，助力用戶高效獲取所需的市場信息。

🚀 快速開始

安裝依賴

運行以下命令安裝所需的依賴項：

npm install

創建 .env 文件

在項目根目錄中創建一個 .env 文件，並添加你的 CoinGecko API 密鑰：

# API Keys
COINGECKO_API_KEY=your_coingecko_api_key_here

構建項目

運行以下命令構建項目：

npm run build

啟動服務器

運行以下命令啟動服務器：

npm start

✨ 主要特性

• 實現 Model Context Protocol（MCP）
• 使用 TypeScript 編寫
• 使用標準輸入輸出（stdio）進行通信
• 提供加密貨幣市場數據，通過 CoinGecko API
• 使用 Zod 進行參數驗證

📦 安裝指南

安裝依賴

運行以下命令安裝所需的依賴項：

npm install

創建 .env 文件

在項目根目錄中創建一個 .env 文件，並添加你的 CoinGecko API 密鑰：

# API Keys
COINGECKO_API_KEY=your_coingecko_api_key_here

構建項目

運行以下命令構建項目：

npm run build

啟動服務器

運行以下命令啟動服務器：

npm start

💻 使用示例

基礎用法

此工具用於獲取特定加密貨幣的歷史市場圖表數據，包括價格、市值和成交量。

參數（均使用 Zod 進行驗證）：

• coinId（可選）：要獲取數據的加密貨幣 ID（例如，'bitcoin'，'ethereum'）。默認為 'bitcoin'。
• vsCurrency（可選）：顯示價格的貨幣單位（例如，'usd'，'eur'，'jpy'）。默認為 'usd'。
• days（可選）：要獲取的數據天數（例如，'1'，'14'，'30'，'90'，'max'）。默認為 '30'。
• interval（可選）：數據的時間間隔。留空則根據時間範圍自動選擇。

示例用法：

{
  "coinId": "ethereum",
  "vsCurrency": "usd",
  "days": "7"
}

📚 詳細文檔

CoinGecko API 文檔

有關 CoinGecko API 的更多信息，請參閱官方文檔：

• CoinGecko API 文檔
• 按 ID 獲取加密貨幣歷史價格圖表數據

開發

使用以下命令進行開發並自動重新編譯：

npm run dev

🔧 技術細節

此服務器使用 @modelcontextprotocol/sdk 創建一個 MCP 服務器，實現以下功能：

1. 通過 stdio 進行通信
2. 提供歷史市場圖表數據
3. 遵循 ES 模塊模式
4. 使用 Zod 方案驗證輸入參數

🔧 擴展服務器

要擴展此服務器：

1. 使用 server.tool() 方法添加更多工具
2. 實現其他 CoinGecko API 端點
3. 嘗試其他傳輸方法，例如 HTTP 或 WebSocket