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网关