Universal Crypto MCP

🚀 通用加密貨幣MCP

通用加密貨幣MCP是一個適用於所有EVM兼容網絡和Solana的通用模型上下文協議服務器。它能讓AI代理（如Claude、ChatGPT、Cursor）通過自然語言與任何EVM區塊鏈進行交互。

🚀 快速開始

Claude桌面版

在claude_desktop_config.json中添加以下內容：

{
  "mcpServers": {
    "universal-crypto-mcp": {
      "command": "npx",
      "args": ["-y", "@nirholas/universal-crypto-mcp@latest"],
      "env": {
        "PRIVATE_KEY": "your_private_key_here (optional)"
      }
    }
  }
}

Cursor

在MCP設置中添加以下內容：

{
  "mcpServers": {
    "universal-crypto-mcp": {
      "command": "npx",
      "args": ["-y", "@nirholas/universal-crypto-mcp@latest"],
      "env": {
        "PRIVATE_KEY": "your_private_key_here (optional)"
      }
    }
  }
}

ChatGPT開發者模式

1. 在ChatGPT設置中啟用開發者模式。
2. 啟動HTTP服務器：

npx @nirholas/universal-crypto-mcp@latest --http

3. 在ChatGPT設置→應用中，點擊創建應用。
4. 輸入服務器URL：http://localhost:3001/mcp。
5. 在對話中通過開發者模式菜單選擇該應用。

詳細設置說明請參考ChatGPT設置指南。

服務器模式

✨ 主要特性

AI服務市場

• 註冊AI服務，可通過按使用付費或訂閱模式立即實現盈利。
• AI代理可按類別、價格和評級自動發現服務。
• 基於鏈上聲譽，通過經過驗證的評級和評論建立信任。
• 提供靈活的定價模式，包括按使用付費、訂閱和免費層級。
• 具備分析儀表盤，可跟蹤使用情況、收入和性能。
• 支持安全支付，包括託管、糾紛解決和自動退款。

x402支付協議

• AI代理可以自動支付高級API費用。
• 支持自主支付，無需人工審批。
• 代理擁有自己的加密錢包，可持有資金。
• 支付使用USDs穩定幣，可獲得約5%的年化收益率。

豐富的功能特性

• Swap/DEX：通過1inch、0x、ParaSwap進行代幣交換。
• Bridge：通過LayerZero、Stargate、Wormhole進行跨鏈轉移。
• Gas：提供各鏈的燃氣價格和EIP - 1559建議。
• Multicall：批量讀寫操作。
• Events/Logs：查詢歷史事件並解碼日誌。
• Security：檢測拉地毯風險、蜜罐，提供GoPlus代幣/地址安全檢查和dApp釣魚檢測。
• Staking：支持流動性質押（如Lido）和LP farming。
• Signatures：簽署消息、驗證簽名和EIP - 712。
• Lending：提供Aave/Compound的借貸頭寸和利率信息。
• Price Feeds：提供歷史價格、TWAP和預言機聚合。
• Portfolio：跨鏈跟蹤資產持有情況。
• Governance：支持Snapshot投票和鏈上提案。
• Deployment：部署合約、CREATE2、可升級代理和驗證。
• MEV Protection：集成Flashbots保護，支持私有交易和捆綁模擬。
• ENS/Domains：註冊、轉移、續訂、設置記錄和子域名。
• Market Data：提供CoinGecko和CoinStats的價格、OHLCV、熱門、類別和交易所信息。
• DeFi Analytics：提供DefiLlama的TVL、收益率、費用、橋樑、穩定幣和協議數據。
• Social Sentiment：提供LunarCrush的社交指標、影響者和熱門話題。
• DEX Analytics：提供DexPaprika和GeckoTerminal的池、交易、OHLCV和熱門代幣信息。
• Predictions：提供Polymarket預測市場和加密預測。
• Technical Indicators：提供50多種技術指標（如RSI、MACD、布林帶等）。
• Alerts：提供價格警報、鯨魚動向警報和燃氣警報。
• WebSockets：提供即時價格流、交易信息和內存池監控。
• Wallet Analytics：跟蹤鯨魚錢包、進行錢包評分和行為分析。
• Multi-Chain：原生支持Cosmos、Near、Sui、Aptos等多鏈。

📦 安裝指南

本地開發

# 克隆倉庫
git clone https://github.com/nirholas/universal-crypto-mcp
cd universal-crypto-mcp

# 安裝依賴
npm install

# 運行開發服務器（stdio - Claude）
npm run dev

# 運行開發服務器（HTTP - ChatGPT）
npm run dev:http

# 運行開發服務器（SSE - 舊版）
npm run dev:sse

環境變量配置

創建一個.env文件，配置可選的API密鑰以增強功能：

# 寫入操作（交換、轉移等）所需
PRIVATE_KEY=your_private_key_here

# 市場數據（可選 - 有免費層級）
COINGECKO_API_KEY=your_key        # https://coingecko.com/api
COINSTATS_API_KEY=your_key        # https://coinstats.app

# 社交情緒（可選）
LUNARCRUSH_API_KEY=your_key       # https://lunarcrush.com/developers

# 新聞（可選）
CRYPTOPANIC_API_KEY=your_key      # https://cryptopanic.com/developers

# 跨鏈交換（可選）
RUBIC_API_KEY=your_key            # https://rubic.exchange

# 自定義RPC端點（可選 - 默認使用公共RPC）
ETHEREUM_RPC_URL=https://mainnet.infura.io/v3/YOUR_KEY
ARBITRUM_RPC_URL=https://arb1.arbitrum.io/rpc
BASE_RPC_URL=https://mainnet.base.org

無API密鑰時的功能情況

💻 使用示例

示例提示（複製粘貼即可使用）

🔄 代幣交換

Swap 0.1 ETH for USDC on Arbitrum

Get me a quote to swap 100 USDC to WBTC on Base

What's the best rate to swap 500 DAI to ETH across all DEXs on Ethereum?

📊 市場數據與價格

What's the current price of Bitcoin and Ethereum in USD?

Show me the top 10 trending coins on CoinGecko right now

Get the 7-day OHLCV data for Solana

What's the market cap and 24h volume of BNB?

Show me the price of token 0xdAC17F958D2ee523a2206206994597C13D831ec7 on Ethereum

🌐 DeFi分析（DefiLlama）

What's the total TVL of Aave across all chains?

Show me the top 10 protocols by TVL

What are the best yield opportunities for stablecoins right now?

How much volume did bridges process in the last 24 hours?

Show me the TVL history of Uniswap over the last 30 days

📈 DEX分析

Show me the top trending pools on Uniswap V3

Get the most traded tokens on Base in the last 24 hours

Find all liquidity pools for PEPE on Ethereum

What's the price and liquidity of the ETH/USDC pool on Aerodrome?

🔒 安全檢查

Is this token safe? 0x95aD61b0a150d79219dCF64E1E6Cc01f0B64C4cE (SHIB)

Check if this token is a honeypot: 0x... on BSC

Scan my wallet for risky approvals: 0xYourAddress

Is this dApp URL safe to connect to? https://suspicious-site.xyz

💰 質押與借貸

What's the current staking APY for ETH on Lido?

Show me Aave lending rates for USDC on Arbitrum

What's my health factor on Aave if I borrow 1000 USDC against 2 ETH?

🌉 跨鏈橋

Bridge 100 USDC from Ethereum to Arbitrum

What's the cheapest way to bridge ETH from mainnet to Base?

Get a bridge quote for 0.5 ETH from Polygon to Optimism

⛽ 燃氣與網絡

What's the current gas price on Ethereum?

Get EIP-1559 gas fees for all supported chains

Is it cheap to transact on Arbitrum right now?

🏛️ 治理

Show me active proposals on Uniswap

What's my voting power on Compound?

Get the results of the latest Aave governance vote

💬 社交情緒（LunarCrush）

What's the social sentiment for Bitcoin right now?

Show me the top crypto influencers on social media

What tokens are trending on Twitter/X today?

Get the Galaxy Score for Ethereum

🆔 ENS域名

Resolve vitalik.eth to an address

Who owns the ENS domain "ethereum.eth"?

Register the domain mycoolname.eth for 1 year

📰 加密新聞

Get the latest crypto news

Search news about Bitcoin ETF

What's the breaking news in DeFi?

📁 投資組合與錢包

Show my token balances on Ethereum: 0xYourAddress

Get all NFTs owned by vitalik.eth

What approvals have I granted from my wallet?

Track my portfolio across all EVM chains

🚀 高級操作

Deploy a new ERC-20 token called "MyToken" (MTK) with 1 million supply on Base

Submit this transaction privately via Flashbots to avoid MEV

Encode a call to the transfer function for 100 USDC

Simulate this transaction before executing: 0x...

📉 技術指標

Calculate RSI for Bitcoin over the last 14 days

Get MACD signal for ETH/USDT on the 4-hour timeframe

Show Bollinger Bands for SOL with 20-period SMA

What's the current trend signal for BTC using multiple indicators?

Run a momentum strategy analysis on DOGE

🔮 預測市場

What are the top crypto prediction markets on Polymarket?

Search for Bitcoin price predictions

What's the current odds for ETH reaching $5000?

📊 事件與日誌

Get all Transfer events for USDC in the last 100 blocks on Ethereum

Show me Approval events for my wallet address

Decode this transaction log: 0x...

✍️ 簽名與消息

Sign this message with my wallet: "Hello World"

Verify this signature is from vitalik.eth

Create an EIP-712 typed data signature for a permit

📦 批量操作（Multicall）

Get token balances for 10 different tokens in one call

Read multiple contract values at once from Aave

Batch check allowances for all my approved tokens

📚 詳細文檔

文檔鏈接

• 綜合指南和API參考：https://mcp.giving

具體文檔分類

• 入門指南
  • 安裝指南
  • 配置
  • 第一個MCP工具
  • 部署指南
• 包文檔
  • 核心包
  • 交易
  • 市場數據
  • 錢包
  • DeFi
  • 支付（x402）
• x402部署文檔
  • 概述
  • 快速開始
  • 配置
  • 提供者
  • 發現
• 貢獻指南
  • 開發指南
  • 測試
  • 發佈

示例代碼

• 基本MCP服務器：包含市場數據工具的最小MCP服務器。
• 付費API示例：為Express API添加x402支付功能。
• 交易機器人：基於RSI + MA策略的自動交易機器人。
• 完整部署：具備所有功能的生產就緒服務器。

每個示例都包含完整的源代碼、帶有設置說明的README、包配置和環境設置指南。

🔧 技術細節

包結構

這是一個最全面的加密貨幣MCP單倉庫，集成了來自最佳MIT許可項目的10多個包：

packages/
├── core/               # 共享類型、實用工具、配置
├── trading/            # CEX交易所集成
│   ├── binance/        # 幣安現貨和期貨
│   ├── binance-us/     # 幣安美國
│   └── bybit/          # Bybit交易所 (ethancod1ng) ⭐ 新增
├── market-data/        # 價格、新聞、分析  
│   ├── prices/         # CoinGecko、DexPaprika、CoinMarketCap
│   ├── news/           # CryptoPanic、聚合新聞
│   ├── analytics/      # 鯨魚跟蹤、恐懼/貪婪指數、Dune
│   ├── predictions/    # AI價格預測
│   ├── crypto-indicators/  # 技術分析 (Kukapay) ⭐ 新增
│   ├── crypto-sentiment/   # 情緒分析 (Kukapay) ⭐ 新增
│   ├── crypto-feargreed/   # 恐懼與貪婪指數 (Kukapay) ⭐ 新增
│   ├── cryptopanic/        # 新聞聚合 (Kukapay)
│   └── coinmarketcap/      # CMC API (Shinzo Labs) ⭐ 新增
├── defi/               # 鏈上DeFi工具 (支持60多個網絡！)
│   ├── protocols/      # EVM MCP服務器 (360⭐)、Sperax、DEX
│   │   ├── algorand/   # Algorand工具 (GoPlausible) ⭐ 新增
│   │   └── bsc-ops/    # BSC操作 (TermiX) ⭐ 新增
│   ├── chain-tools/    # BNB鏈、鏈上MCP
│   └── agents/         # 自主DeFi代理
├── wallets/            # 錢包管理
│   ├── evm/            # 以太坊和EVM錢包
│   └── solana/         # Solana錢包
├── payments/           # 支付基礎設施
│   └── x402/           # x402協議、USDC轉移
├── automation/         # 機器人和自動化
│   ├── social/         # XActions Twitter自動化
│   ├── sweep/          # 清掃零頭代幣
│   └── volume/         # 交易量工具
└── generators/         # 用於構建MCP服務器的元工具
    ├── abi-to-mcp/     # 將ABIs轉換為MCP工具
    ├── repo-to-mcp/    # GitHub倉庫 → MCP服務器
    ├── doc-extractor/  # 為大語言模型提取文檔
    ├── registry/       # Lyra工具註冊表
    └── discovery/      # 工具發現和搜索

📖 查看包文檔 →

集成的社區MCP服務器

該倉庫整合了最佳的MIT許可加密貨幣MCP項目，並給予了適當的歸屬：

所有集成項目都保留了原始的MIT許可證，並進行了完整的歸屬說明。詳細的歸屬信息和修改內容請參考CONTRIBUTORS.md。

支持的網絡

EVM鏈

• 以太坊、BNB智能鏈（BSC）、Polygon、Arbitrum、Base、Optimism
• Avalanche、Fantom、zkSync Era、Linea、Scroll、Blast、Mode、Mantle
• opBNB + 所有測試網

多鏈（新增）

• Cosmos/IBC - ATOM、OSMO、JUNO、INJ等
• Near協議 - 原生NEAR + 合約
• Sui - 支持Move的SUI
• Aptos - 支持Move的APT
• 比特幣、萊特幣、Solana、TON、XRP、THORChain

x402支付協議

x402簡介

x402實現了HTTP 402支付要求，使AI代理能夠：

• 自動支付高級API訪問費用。
• 進行自主支付，無需人工審批。
• 擁有自己的加密錢包以持有資金。
• 使用USDs穩定幣支付，可獲得約5%的年化收益率。

快速設置

# 添加到環境變量
export X402_PRIVATE_KEY=0x...  # 你的EVM私鑰
export X402_CHAIN=arbitrum      # 默認鏈 (或base, ethereum, polygon)

x402工具（共14個）

支持的網絡

示例

User: "Get premium weather data for Tokyo"
Agent: [calls x402_pay_request to weather API]
       [automatically pays $0.01 in USDs]
       "Here's the detailed forecast..."

x402架構

┌─────────┐      ┌───────────┐      ┌───────────┐
│ Claude  │─────▶│ MCP Server│─────▶│ Paid API  │
│  (AI)   │      │  (x402)   │      │   (402)   │
└─────────┘      └───────────┘      └───────────┘
     │                │                   │
     │  "Get data"    │  HTTP + Payment   │
     │                │                   │
     └────────────────┴───────────────────┘

📖 完整文檔：

• x402 README - 概述和快速開始
• 快速入門指南 - 5分鐘設置
• MCP工具參考 - 所有14個工具說明
• 架構 - 技術深入剖析
• 示例 - 實際用例
• 安全指南 - 最佳實踐

測試

測試框架

使用Vitest作為測試框架，具有全面的測試覆蓋率。

運行測試

# 運行所有單元測試
npm test

# 以監聽模式運行測試（文件更改時重新運行）
npm run test:watch

# 運行帶覆蓋率報告的測試
npm run test:coverage

# 運行端到端測試（需要網絡訪問）
npm run test:e2e

# 以監聽模式運行端到端測試
npm run test:e2e:watch

# 打開交互式測試界面
npm run test:ui

MCP檢查器

使用官方的MCP檢查器交互式測試MCP工具：

npm run test:inspector

通過此瀏覽器界面，你可以：

• 瀏覽所有可用的工具和提示。
• 使用自定義參數測試工具執行。
• 查看工具響應並調試問題。
• 驗證MCP服務器實現。

測試結構

tests/
├── setup.ts              # 全局測試設置
├── e2e/                  # 端到端測試
│   ├── evm-tools.e2e.test.ts
│   └── market-data.e2e.test.ts
├── integration/          # 集成測試
│   ├── evm-tools.test.ts
│   └── multichain.test.ts
└── mocks/                # 測試模擬和固定數據

src/
├── evm/
│   ├── chains.test.ts    # 與源代碼一起的單元測試
│   └── modules/
│       └── */tools.test.ts
└── utils/
    ├── errors.test.ts
    ├── helper.test.ts
    └── validation.test.ts

路線圖

這是一個全面的路線圖，涵蓋了所有待實現的加密貨幣/區塊鏈/DeFi/Web3功能。

圖例

• ✅ 已實現
• 🚧 進行中
• 📋 計劃中

數據來源

該MCP服務器集成了以下API：

相關MCP服務器

Binance.com服務器

提供完整的Binance全球API覆蓋，包括現貨交易、錢包、質押、挖礦、兌換、簡單收益、算法交易、NFT、支付、跟單交易、雙幣投資、VIP貸款、C2C/P2P、法幣等功能。

{
  "mcpServers": {
    "binance": {
      "command": "npx",
      "args": ["ts-node", "binance-mcp-server/src/index.ts"],
      "env": {
        "BINANCE_API_KEY": "your_key",
        "BINANCE_API_SECRET": "your_secret"
      }
    }
  }
}

Binance.US服務器

這是一個受美國監管的交易所，提供市場數據、現貨交易、錢包、質押、OTC、子賬戶和託管解決方案（面向機構）。

{
  "mcpServers": {
    "binance-us": {
      "command": "node",
      "args": ["binance-us-mcp-server/build/index.js"],
      "env": {
        "BINANCE_US_API_KEY": "your_key",
        "BINANCE_US_API_SECRET": "your_secret"
      }
    }
  }
}

📄 許可證

本項目採用Apache - 2.0許可證，版權歸**nich**所有。

🌐 即時HTTP部署

通用加密貨幣MCP已部署並可通過MCP可流式HTTP傳輸進行HTTP訪問，無需本地安裝。

端點

https://modelcontextprotocol.name/mcp/universal-crypto-mcp

從任何MCP客戶端連接

在MCP客戶端配置（Claude桌面版、Cursor、SperaxOS等）中添加以下內容：

{
  "mcpServers": {
    "universal-crypto-mcp": {
      "type": "http",
      "url": "https://modelcontextprotocol.name/mcp/universal-crypto-mcp"
    }
  }
}

可用工具（11個）

示例請求

獲取加密貨幣價格

curl -X POST https://modelcontextprotocol.name/mcp/universal-crypto-mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_price","arguments":{"ids":"bitcoin","vs_currencies":"usd"}}}'

市場概覽

curl -X POST https://modelcontextprotocol.name/mcp/universal-crypto-mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_market_overview","arguments":{"limit":10}}}'

熱門代幣

curl -X POST https://modelcontextprotocol.name/mcp/universal-crypto-mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_trending","arguments":{}}}'

列出所有工具

curl -X POST https://modelcontextprotocol.name/mcp/universal-crypto-mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

其他可用平臺

• SperaxOS — 從MCP市場瀏覽和安裝。
• 所有27個MCP服務器 — 請在modelcontextprotocol.name查看完整目錄。

由modelcontextprotocol.name提供支持 — 開放的MCP HTTP網關