Goldrush MCP Server

🚀 金色rush模型上下文協議服務器

金色rush MCP（Model Context Protocol）服務器是一款用於連接和管理區塊鏈數據的實用工具。它提供了多個服務模塊，可高效處理餘額查詢、交易分析、NFT數據等各類任務，為區塊鏈數據分析提供有力支持。

🚀 快速開始

金色rush MCP服務器能幫助你輕鬆連接和管理區塊鏈數據，下面為你介紹詳細的使用步驟。

✨ 主要特性

• 提供多個服務模塊，可處理餘額查詢、交易分析、NFT數據等多種任務。
• 模塊化設計，便於擴展和維護。

📦 安裝指南

先決條件

• Node.js 版本18或更高
• npm、yarn 或 pnpm
• 環境變量 GOLDRUSH_API_KEY，需包含有效的金色rush API密鑰

安裝步驟

首先，克隆項目倉庫：

git clone https://github.com/covalenthq/goldrush-mcp-server.git
cd goldrush-mcp-server
npm install

然後，進行項目構建：

npm run build

💻 使用示例

啟動MCP服務器

# 啟動服務器（運行dist/index.js）
npm run start

啟動後，MCP服務器將等待MCP客戶端的連接。

運行示例客戶端

你可以運行示例客戶端，該客戶端會作為子進程通過STDIO啟動服務器：

npm run example

此示例會嘗試進行幾次Covalent調用並打印響應結果。

運行測試

npm run test

運行該命令將執行整個測試套件，對每個服務的功能進行全面測試。

設置GOLDRUSH_API_KEY

你必須將環境變量 GOLDRUSH_API_KEY 設置為有效的金色rush API密鑰。

• 在Linux/macOS上：

export GOLDRUSH_API_KEY=YOUR_KEY_HERE

• 在Windows上：

set GOLDRUSH_API_KEY=YOUR_KEY_HERE

📚 詳細文檔

文件佈局

goldrush-mcp-server
├── src
│   ├── index.ts                 # MCP服務器的主要入口點
│   ├── services/                # 模塊化服務實現
│   │   ├── AllChainsService.ts  # 跨鏈工具
│   │   ├── BalanceService.ts    # 處理餘額相關請求的工具
│   │   ├── BaseService.ts       # 基本區塊鏈工具
│   │   ├── BitcoinService.ts    # 特定於比特幣的工具
│   │   ├── NftService.ts        # NFT相關的工具
│   │   ├── PricingService.ts    # 處理定價相關請求的工具
│   │   ├── SecurityService.ts   # 安全相關的工具
│   │   └── TransactionService.ts# 處理交易相關請求的工具
│   ├── resources/               # 資源實現
│   │   ├── staticResources.ts   # 靜態配置資源
│   │   └── dynamicResources.ts  # 動態鏈狀態資源
│   ├── utils/                   # 工具函數和常量
│   │   ├── constants.ts         # 共享常量
│   │   └── helpers.ts           # 輔助函數
│   └── example-client.ts        # 使用STDIO傳輸的示例LLM客戶端
├── test
│   ├── AllChainsService.test.ts
│   ├── BalanceService.test.ts
│   ├── BaseService.test.ts
│   ├── BitcoinService.test.ts
│   ├── NftService.test.ts
│   ├── PricingService.test.ts
│   ├── Resources.test.ts
│   ├── SecurityService.test.ts
│   └── TransactionService.test.ts
├── eslint.config.mjs            # ESLint配置
├── package.json                 # 項目依賴和腳本
├── package-lock.json            # 依賴管理鎖定文件
├── README.md                    # 項目文檔
└── dist/                        # 構建輸出目錄

📄 許可證

文檔中未提及許可證相關信息。

貢獻指南

• 問題報告：請在GitHub倉庫中提交問題。
• 代碼貢獻：請fork倉庫並提交pull request。

其他信息

金色rush MCP服務器是一個開源項目，旨在為區塊鏈數據分析提供支持。更多詳細信息請訪問 GitHub倉庫。