金大哥 - sperax-crypto-mcp MCP 详情

article

README

🚀 BNB Chain MCP Server

BNB Chain MCP Server 是专为币安智能链（BNB Chain）和 opBNB 优化的模型上下文协议（MCP）服务器，同时也支持其他与 EVM 兼容的区块链。它使 Claude、ChatGPT 和 Cursor 等 AI 助手能够通过自然语言与区块链网络进行交互。

🚀 快速开始

在不到 60 秒的时间内启动并运行！

选项 1：Claude Desktop（推荐）

将以下内容添加到 claude_desktop_config.json 文件中：

{
  "mcpServers": {
    "bnb-chain-mcp": {
      "command": "npx",
      "args": ["-y", "@nirholas/bnb-chain-mcp@latest"]
    }
  }
}

📁 配置文件位置

| 操作系统 | 路径 | |----|------| | macOS | ~/Library/Application Support/Claude/claude_desktop_config.json | | Windows | %APPDATA%\Claude\claude_desktop_config.json | | Linux | ~/.config/claude/claude_desktop_config.json |

选项 2：Cursor / VS Code

将以下内容添加到 MCP 设置中：

{
  "mcpServers": {
    "bnb-chain-mcp": {
      "command": "npx",
      "args": ["-y", "@nirholas/bnb-chain-mcp@latest"]
    }
  }
}

选项 3：ChatGPT 开发者模式

在 ChatGPT 设置中启用开发者模式。

启动 HTTP 服务器：

npx @nirholas/bnb-chain-mcp@latest --http

在 ChatGPT 设置 → 应用中，点击 创建应用。
输入服务器 URL：http://localhost:3001/mcp。
通过 开发者模式 菜单在对话中选择该应用。

📖 完整的 ChatGPT 设置指南

选项 4：npx 即时启动

# stdio 模式（Claude、Cursor）
npx @nirholas/bnb-chain-mcp@latest

# HTTP 模式（ChatGPT 开发者模式）
npx @nirholas/bnb-chain-mcp@latest --http

# SSE 模式（旧版客户端）
npx @nirholas/bnb-chain-mcp@latest --sse

✨ 主要特性

功能矩阵

| 类别 | 功能 | 状态 | |----------|----------|--------| | Swap/DEX | 通过 1inch、0x、ParaSwap 进行代币交换 | ✅ | | Bridge | 通过 LayerZero、Stargate 进行跨链转移 | ✅ | | Gas | 各链的燃气价格，EIP - 1559 建议 | ✅ | | Multicall | 批量读写操作 | ✅ | | Events/Logs | 查询历史事件，解码日志 | ✅ | | Security | 拉地毯风险检测、蜜罐检查、GoPlus 集成 | ✅ | | Staking | 流动性质押（Lido）、LP 挖矿 | ✅ | | Signatures | 签署消息、验证签名、EIP - 712 | ✅ | | Lending | Aave/Compound 头寸、借款利率 | ✅ | | Price Feeds | 历史价格、时间加权平均价格（TWAP）、预言机聚合 | ✅ | | Portfolio | 跨链跟踪资产 | ✅ | | Governance | Snapshot 投票、链上提案 | ✅ | | Deployment | 部署合约、CREATE2、可升级代理 | ✅ | | MEV Protection | Flashbots 保护、私密交易 | ✅ | | ENS/Domains | 注册、转移、续费、设置记录 | ✅ | | Market Data | CoinGecko 价格、OHLCV、热门代币 | ✅ | | DeFi Analytics | DefiLlama TVL、收益率、费用、协议 | ✅ | | Social Sentiment | LunarCrush 指标、影响者、热门话题 | ✅ | | DEX Analytics | GeckoTerminal 交易池、交易、OHLCV | ✅ |

工具类别

🔗 核心区块链（45 + 工具）

| 工具 | 描述 | |------|-------------| | get_chain_info | 获取链 ID、区块编号、燃气价格 | | get_block | 通过编号或哈希获取区块 | | get_transaction | 获取交易详情和收据 | | send_transaction | 发送原生代币转移 | | estimate_gas | 估算交易燃气 | | get_balance | 获取原生/代币余额 | | call_contract | 调用视图/纯合约函数 | | ... | 查看完整列表 → |

💰 代币操作（30 + 工具）

| 工具 | 描述 | |------|-------------| | get_token_info | 获取名称、符号、小数位数、供应量 | | get_token_balance | 获取地址的代币余额 | | transfer_token | 转移 ERC - 20 代币 | | approve_token | 批准支出额度 | | get_nft_metadata | 获取 NFT 元数据和特征 | | transfer_nft | 转移 ERC - 721 NFT | | ... | 查看完整列表 → |

🏦 去中心化金融（DeFi，50 + 工具）

| 工具 | 描述 | |------|-------------| | get_swap_quote | 从 DEX 聚合器获取交换报价 | | execute_swap | 执行代币交换 | | add_liquidity | 向 DEX 交易池添加流动性 | | get_lending_rates | 获取 Aave/Compound 利率 | | supply_to_lending | 向借贷协议供应资产 | | get_farming_apy | 获取收益 farming APY | | ... | 查看完整列表 → |

🔒 安全（15 + 工具）

| 工具 | 描述 | |------|-------------| | check_token_security | GoPlus 代币安全分析 | | detect_honeypot | 检查代币是否为蜜罐 | | check_rug_pull | 评估拉地毯风险 | | get_holder_distribution | 获取前持有者细分 | | check_contract_verified | 验证合约源代码 | | screen_address | 检查地址风险评分 | | ... | 查看完整列表 → |

📊 市场数据（25 + 工具）

| 工具 | 描述 | |------|-------------| | get_price | 获取当前代币价格 | | get_price_history | 获取历史 OHLCV 数据 | | get_trending_coins | 获取热门代币 | | get_tvl | 从 DefiLlama 获取协议 TVL | | get_dex_pools | 获取 DEX 交易池数据 | | get_social_metrics | 获取 LunarCrush 情绪指标 | | ... | 查看完整列表 → |

🌐 支持的网络

| 网络 | 链 ID | 原生代币 | 状态 | |---------|----------|--------------|--------| | 币安智能链（BNB Smart Chain） | 56 | BNB | ✅ 完全支持 | | opBNB | 204 | BNB | ✅ 完全支持 | | Arbitrum One | 42161 | ETH | ✅ 完全支持 | | 以太坊（Ethereum） | 1 | ETH | ✅ 完全支持 | | Polygon | 137 | MATIC | ✅ 完全支持 | | Base | 8453 | ETH | ✅ 完全支持 | | Optimism | 10 | ETH | ✅ 完全支持 | | 雪崩 C 链（Avalanche C - Chain） | 43114 | AVAX | ✅ 完全支持 | | Fantom | 250 | FTM | ✅ 完全支持 | | Gnosis | 100 | xDAI | ✅ 完全支持 | | BSC 测试网（BSC Testnet） | 97 | tBNB | ✅ 测试网 | | Sepolia | 11155111 | SepoliaETH | ✅ 测试网 | | Goerli | 5 | GoerliETH | ✅ 测试网 |

添加自定义网络

{
  "mcpServers": {
    "bnb-chain-mcp": {
      "command": "npx",
      "args": ["-y", "@nirholas/bnb-chain-mcp@latest"],
      "env": {
        "CUSTOM_RPC_56": "https://your-bnb-rpc.com",
        "CUSTOM_RPC_1": "https://your-eth-rpc.com"
      }
    }
  }
}

📦 安装指南

服务器模式

| 模式 | 命令 | 使用场景 | |------|---------|----------| | stdio | npx @nirholas/bnb-chain-mcp | Claude Desktop、Cursor | | HTTP | npx @nirholas/bnb-chain-mcp --http | ChatGPT 开发者模式 | | SSE | npx @nirholas/bnb-chain-mcp --sse | 旧版 HTTP 客户端 |

从 npm 安装（推荐）

# 直接使用 npx 运行（无需安装）
npx @nirholas/bnb-chain-mcp@latest

# 或者全局安装
npm install -g @nirholas/bnb-chain-mcp

# 然后运行
bnb-chain-mcp

从源代码安装

# 克隆仓库
git clone https://github.com/nirholas/bnb-chain-mcp
cd bnb-chain-mcp

# 安装依赖
bun install

# 构建
bun run build

# 运行开发服务器（stdio - Claude）
bun dev

# 运行开发服务器（HTTP - ChatGPT）
bun dev:http

# 运行开发服务器（SSE - 旧版）
bun dev:sse

使用 Docker 安装

# 构建镜像
docker build -t bnb-chain-mcp .

# 运行 stdio 模式
docker run -it bnb-chain-mcp

# 运行 HTTP 模式
docker run -p 3001:3001 bnb-chain-mcp --http

⚙️ 配置

环境变量

| 变量 | 描述 | 默认值 | 是否必需 | |----------|-------------|---------|----------| | PRIVATE_KEY | 用于交易的钱包私钥 | - | 否（无则为只读模式） | | COINGECKO_API_KEY | CoinGecko Pro API 密钥 | - | 否 | | COINSTATS_API_KEY | CoinStats API 密钥 | - | 否 | | LUNARCRUSH_API_KEY | LunarCrush API 密钥 | - | 否 | | CRYPTOPANIC_API_KEY | CryptoPanic 新闻 API 密钥 | - | 否 | | CUSTOM_RPC_<CHAIN_ID> | 特定链的自定义 RPC | - | 否 | | PORT | HTTP 服务器端口 | 3001 | 否 | | LOG_LEVEL | 日志级别 | info | 否 |

完整配置示例

{
  "mcpServers": {
    "bnb-chain-mcp": {
      "command": "npx",
      "args": ["-y", "@nirholas/bnb-chain-mcp@latest"],
      "env": {
        "PRIVATE_KEY": "0x...",
        "COINGECKO_API_KEY": "CG-xxx",
        "LUNARCRUSH_API_KEY": "xxx",
        "CUSTOM_RPC_56": "https://bsc-rpc.publicnode.com",
        "CUSTOM_RPC_1": "https://eth-rpc.publicnode.com",
        "LOG_LEVEL": "debug"
      }
    }
  }
}

Claude Desktop 配置

macOS

# 打开配置文件
open ~/Library/Application\ Support/Claude/claude_desktop_config.json

Windows

# 打开配置文件
notepad %APPDATA%\Claude\claude_desktop_config.json

Linux

# 打开配置文件
nano ~/.config/claude/claude_desktop_config.json

📊 数据来源

此 MCP 服务器集成了以下 API： | 提供商 | 数据类型 | API 密钥 | 速率限制 | |----------|-----------|---------|-------------| | CoinGecko | 市场数据、价格、OHLCV | 可选 | 10 - 50 请求/分钟 | | CoinStats | 投资组合、价格、钱包 | 必需 | 不同 | | DefiLlama | TVL、收益率、费用、协议 | 否 | 宽松 | | LunarCrush | 社交情绪、影响者 | 必需 | 不同 | | GoPlus | 安全分析、蜜罐检测 | 否 | 宽松 | | GeckoTerminal | DEX 交易池、交易、OHLCV | 否 | 宽松 | | DexPaprika | DEX 分析、交易池 | 否 | 宽松 | | CryptoPanic | 加密新闻 | 必需 | 不同 | | Alternative.me | 恐惧与贪婪指数 | 否 | 宽松 |

💻 使用示例

价格查询

用户：“BNB 当前的价格是多少？”

AI：使用 get_price 工具 → “BNB 当前的交易价格为 $XXX.XX，在过去 24 小时内上涨了 2.5%。”

安全检查

用户：“这个代币安全吗？0x...”

AI：使用 check_token_security 和 detect_honeypot 工具 → “⚠️ 警告：这个代币有几个危险信号...”

DEX 分析

用户：“给我展示最好的 BNB 流动性交易池”

AI：使用 get_dex_pools 工具 → “以下是币安智能链上按 TVL 排名的顶级交易池...”

跨链投资组合

用户：“检查我在所有链上的钱包：0x...”

AI：使用 get_portfolio 工具 → “你在 5 条链上的总投资组合价值为 $X...”

DeFi 研究

用户：“币安智能链上有哪些最好的收益 farming 机会？”

AI：使用 get_yield_farms 和 get_tvl 工具 → “以下是顶级的收益机会...”

🏗️ 架构

┌──────────────────────────────────────────────────────────────────────────────┐
│                          BNB Chain MCP Server                                │
├──────────────────────────────────────────────────────────────────────────────┤
│                                                                              │
│  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐                        │
│  │    stdio     │  │     HTTP     │  │      SSE     │   Transport Layer      │
│  │   (Claude)   │  │   (ChatGPT)  │  │   (Legacy)   │                        │
│  └──────┬───────┘  └──────┬───────┘  └──────┬───────┘                        │
│         │                 │                 │                                │
│         └─────────────────┼─────────────────┘                                │
│                           │                                                  │
│                           ▼                                                  │
│  ┌───────────────────────────────────────────────────────────────────────┐   │
│  │                        MCP Protocol Handler                           │   │
│  │     Tools Registration  |  Resource Management  |  Prompt Templates   │   │
│  └───────────────────────────────────────────────────────────────────────┘   │
│                           │                                                  │
│         ┌─────────────────┼─────────────────┐                                │
│         ▼                 ▼                 ▼                                │
│  ┌────────────┐    ┌────────────┐    ┌────────────┐                          │
│  │ Blockchain │    │   Market   │    │  Security  │    Tool Categories       │
│  │   Tools    │    │    Data    │    │   Tools    │                          │
│  └─────┬──────┘    └─────┬──────┘    └─────┬──────┘                          │
│        │                 │                 │                                 │
│        ▼                 ▼                 ▼                                 │
│  ┌───────────────────────────────────────────────────────────────────────┐   │
│  │                         Provider Integrations                         │   │
│  │   viem | CoinGecko | DefiLlama | GoPlus | LunarCrush | GeckoTerminal  │   │
│  └───────────────────────────────────────────────────────────────────────┘   │
│                           │                                                  │
│                           ▼                                                  │
│  ┌───────────────────────────────────────────────────────────────────────┐   │
│  │                           EVM Networks                                │   │
│  │   BNB Chain | Ethereum | Arbitrum | Polygon | Base | Optimism | ...   │   │
│  └───────────────────────────────────────────────────────────────────────┘   │
│                                                                              │
└──────────────────────────────────────────────────────────────────────────────┘

模块组织

src/
├── index.ts              # 入口点
├── server/
│   ├── stdio.ts          # stdio 传输
│   ├── http.ts           # HTTP 传输
│   └── sse.ts            # SSE 传输
├── tools/
│   ├── blockchain/       # 核心链操作
│   ├── tokens/           # 代币操作
│   ├── defi/             # DeFi 协议
│   ├── security/         # 安全检查
│   ├── market/           # 市场数据
│   └── social/           # 社交情绪
├── providers/
│   ├── coingecko.ts      # CoinGecko API
│   ├── defillama.ts      # DefiLlama API
│   ├── goplus.ts         # GoPlus 安全
│   └── ...
└── utils/
    ├── chains.ts         # 链配置
    ├── abi.ts            # 通用 ABI
    └── format.ts         # 格式化工具

🔐 安全

安全模型

| 特性 | 描述 | |---------|-------------| | 只读模式 | 没有 PRIVATE_KEY 时，服务器仅读取区块链状态 | | 无密钥存储 | 私钥从不存储，仅在内存中使用 | | 输入验证 | 所有输入使用 Zod 模式进行验证 | | 速率限制 | 内置速率限制防止 API 滥用 | | 验证来源 | 仅使用信誉良好的数据提供商 |

最佳实践

⚠️ 切勿在公共配置中分享 你的 PRIVATE_KEY。
✅ 使用环境变量或密钥管理。
✅ 尽可能使用只读模式。
✅ 在交互前始终验证代币安全性。
✅ 在执行交易前审查交易模拟。

❓ 故障排除

服务器无法启动

检查 Node.js 版本（需要 18+）：
```
node --version
```
清除 npx 缓存：
```
npx clear-npx-cache
```
尝试全局安装：
```
npm install -g @nirholas/bnb-chain-mcp
```

Claude Desktop 无法识别服务器

验证配置文件位置和 JSON 语法。
完全重启 Claude Desktop。
检查日志：
- macOS：~/Library/Logs/Claude/mcp*.log
- Windows：%APPDATA%\Claude\logs\mcp*.log

RPC 错误 / 速率限制

使用专用的 RPC 提供商（Alchemy、QuickNode 等）。

配置自定义 RPC：

"env": {
  "CUSTOM_RPC_56": "https://your-dedicated-rpc.com"
}

API 密钥错误

验证 API 密钥是否正确（无多余空格）。
检查 API 密钥是否具有所需权限。
验证速率限制是否未被超出。

🗺️ 路线图

这是一个全面的路线图，涵盖了所有待实现的加密/区块链/DeFi/Web3 功能。

图例

✅ 已实现
🚧 进行中
📋 计划中

🔗 核心区块链操作

网络与链

| 功能 | 状态 | |---------|--------| | 获取链 ID、区块编号、燃气价格 | ✅ | | 获取网络状态/健康状况 | ✅ | | 切换网络/链 | ✅ | | 获取支持的网络列表 | ✅ | | 获取 RPC 端点 | ✅ | | 估算区块时间 | ✅ | | 获取链元数据（名称、符号、浏览器） | ✅ | | 获取最终性状态 | ✅ | | 获取内存池/待处理交易 | ✅ | | 获取网络对等节点/节点 | ✅ | | 获取燃气预言机 | ✅ |

区块

| 功能 | 状态 | |---------|--------| | 通过编号/哈希获取区块 | ✅ | | 获取最新区块 | ✅ | | 获取区块交易 | ✅ | | 获取区块收据 | ✅ | | 获取叔块 | ✅ | | 订阅新区块 | 📋 | | 获取区块奖励 | ✅ | | 获取区块使用/限制的燃气 | ✅ | | 获取区块范围 | ✅ | | 获取矿工的区块 | ✅ |

交易

| 功能 | 状态 | |---------|--------| | 发送交易 | ✅ | | 通过哈希获取交易 | ✅ | | 获取交易收据 | ✅ | | 获取交易状态 | ✅ | | 估算燃气 | ✅ | | 加速交易（用更高的燃气替换） | ✅ | | 取消交易 | ✅ | | 解码交易输入 | ✅ | | 模拟交易 | ✅ | | 获取交易跟踪 | 📋 | | 获取内部交易 | 📋 | | 批量交易 | ✅ | | 获取待处理交易 | ✅ | | 获取地址的交易历史 | ✅ |

账户/钱包

| 功能 | 状态 | |---------|--------| | 获取余额（原生/代币） | ✅ | | 获取随机数 | ✅ | | 获取交易计数 | ✅ | | 创建钱包 | ✅ | | 导入钱包（私钥/助记词） | ✅ | | 导出私钥 | 📋 | | 签署消息 | ✅ | | 验证签名 | ✅ | | 从私钥获取地址 | ✅ | | 生成助记词 | ✅ | | 派生地址（HD 钱包） | ✅ | | 多签钱包操作 | 📋 | | 获取钱包权限 | 📋 | | 撤销批准 | ✅ | | 账户抽象（ERC - 4337） | 📋 | | 社交恢复 | 📋 | | 硬件钱包集成 | 📋 | | 获取钱包投资组合 | ✅ | | 获取代币批准 | ✅ |

💰 代币操作

原生代币

| 功能 | 状态 | |---------|--------| | 获取原生余额 | ✅ | | 转移原生代币 | ✅ | | 包装/解包原生代币（WETH、WBNB） | ✅ |

ERC - 20（可替代代币）

| 功能 | 状态 | |---------|--------| | 获取代币信息（名称、符号、小数位数、总供应量） | ✅ | | 获取代币余额 | ✅ | | 转移代币 | ✅ | | 批准支出 | ✅ | | 获取批准额度 | ✅ | | 从（委托）转移 | ✅ | | 燃烧代币 | ✅ | | 铸造代币 | ✅ | | 获取代币持有者 | ✅ | | 获取代币转移 | ✅ | | 许可（无燃气批准 - EIP - 2612） | ✅ | | 批量转移 | ✅ | | 代币快照 | 📋 | | 获取代币供应信息 | ✅ | | 检查/撤销代币批准 | ✅ |

ERC - 721（NFT）

| 功能 | 状态 | |---------|--------| | 获取 NFT 元数据 | ✅ | | 获取 NFT 所有者 | ✅ | | 转移 NFT | ✅ | | 批准 NFT | ✅ | | 为所有设置批准 | ✅ | | 获取所有者的 NFT | ✅ | | 获取 NFT 集合信息 | ✅ | | 铸造 NFT | 📋 | | 燃烧 NFT | 📋 | | 获取 NFT 转移历史 | 📋 | | 获取 NFT 特征/属性 | ✅ | | 获取 NFT 稀有度 | 📋 | | 验证 NFT 真实性 | 📋 | | 批量转移 NFT | ✅ | | 检查 NFT 批准 | ✅ | | 撤销 NFT 批准 | ✅ | | 为市场批准 | ✅ | | 从 URI 获取 NFT 元数据 | ✅ |

ERC - 1155（多代币）

| 功能 | 状态 | |---------|--------| | 获取代币余额（可替代 + NFT） | ✅ | | 批量转移 | 📋 | | 批量余额查询 | 📋 | | 安全转移 | ✅ | | 获取 URI | ✅ |

其他代币标准

| 功能 | 状态 | |---------|--------| | ERC - 777（高级可替代） | 📋 | | ERC - 3525（半可替代） | 📋 | | ERC - 4626（代币化金库） | 📋 | | ERC - 6551（代币绑定账户） | 📋 | | ERC - 404（混合代币） | 📋 | | 灵魂绑定代币（SBTs） | 📋 |

🏦 去中心化金融 - 去中心化交易所（DEX）

交换

| 功能 | 状态 | |---------|--------| | 获取报价/价格 | ✅ | | 用精确代币交换代币 | ✅ | | 用代币交换精确代币 | ✅ | | 多跳交换 | ✅ | | 拆分路由交换 | 📋 | | 跨 DEX 聚合 | ✅ | | 限价订单 | 📋 | | 时间加权平均价格（TWAP）订单 | 📋 | | 止损订单 | 📋 | | 获取滑点估计 | ✅ | | 获取价格影响 | ✅ | | MEV 保护（私密交易） | 📋 |

DEX 分析

| 功能 | 状态 | |---------|--------| | 获取热门交易池 | ✅ | | 获取新交易池 | ✅ | | 按交易量获取顶级交易池 | ✅ | | 获取交易池 OHLCV 数据 | ✅ | | 获取交易池交易 | ✅ | | 获取代币交易池 | ✅ | | 获取 DEX 列表 | ✅ | | 跨链搜索交易池 | ✅ | | 通过合约获取代币价格 | ✅ | | 获取交易池交易 | ✅ | | 多代币价格查询 | ✅ |

流动性提供

| 功能 | 状态 | |---------|--------| | 添加流动性 | ✅ | | 移除流动性 | ✅ | | 获取 LP 代币余额 | ✅ | | 获取交易池储备 | ✅ | | 获取交易池 APY/APR | 📋 | | 获取无常损失估计 | 📋 | | 集中流动性（Uniswap V3） | 📋 | | 设置价格范围 | 📋 | | 收取费用 | 📋 | | 重新平衡头寸 | 📋 | | 用原生代币添加流动性 | ✅ | | 计算套利机会 | ✅ |

AMM 类型支持

| 功能 | 状态 | |---------|--------| | 恒定乘积（x * y = k） | ✅ | | 稳定交换（Curve） | 📋 | | 集中流动性 | 📋 | | 订单簿混合 | 📋 | | 虚拟 AMM（永续合约） | 📋 |

🏦 去中心化金融 - 借贷

借贷

| 功能 | 状态 | |---------|--------| | 供应/存入资产 | ✅ | | 提取资产 | ✅ | | 获取供应 APY | ✅ | | 获取供应余额 | ✅ | | 获取利用率 | 📋 | | 启用/禁用作为抵押品 | 📋 |

借款

| 功能 | 状态 | |---------|--------| | 借款 | ✅ | | 偿还债务 | ✅ | | 获取借款 APY | ✅ | | 获取借款余额 | ✅ | | 获取健康因子 | ✅ | | 获取清算阈值 | ✅ | | 获取最大可借款金额 | 📋 | | 闪电贷 | ✅ | | 获取借款限额 | 📋 | | 获取闪电贷信息 | ✅ |

清算

| 功能 | 状态 | |---------|--------| | 清算不健康头寸 | 📋 | | 获取可清算头寸 | ✅ | | 获取清算奖励 | 📋 | | 部分清算 | 📋 |

隔离市场

| 功能 | 状态 | |---------|--------| | 向隔离池供应 | 📋 | | 从隔离池借款 | 📋 | | 获取隔离模式债务上限 | 📋 |

🥩 去中心化金融 - 质押

原生质押

| 功能 | 状态 | |---------|--------| | 质押原生代币 | ✅ | | 解除质押/提取 | ✅ | | 领取奖励 | ✅ | | 获取质押 APY | ✅ | | 获取验证者列表 | 📋 | | 委托给验证者 | 📋 | | 重新委托 | 📋 | | 获取解锁期 | 📋 |

流动性质押

| 功能 | 状态 | |---------|--------| | 质押获取流动性质押代币（stETH、rETH） | ✅ | | 解包流动性质押代币 | ✅ | | 获取兑换率 | ✅ | | 获取质押奖励率 | ✅ |

LP 质押/挖矿

| 功能 | 状态 | |---------|--------| | 质押 LP 代币 | ✅ | | 解除质押 LP 代币 | ✅ | | 领取挖矿奖励 | ✅ | | 获取挖矿 APY | ✅ | | 复利奖励 | 📋 | | 获取待领取奖励 | ✅ | | 提升奖励（veTokens） | 📋 |

再质押

| 功能 | 状态 | |---------|--------| | 再质押资产（EigenLayer） | 📋 | | 获取再质押点数 | 📋 | | 选择运营商 | 📋 | | 从再质押中提取 | 📋 |

📊 去中心化金融 - 衍生品

永续期货

| 功能 | 状态 | |---------|--------| | 开多/空仓 | 📋 | | 平仓 | 📋 | | 添加/移除保证金 | 📋 | | 设置杠杆 | 📋 | | 获取资金费率 | 📋 | | 获取未平仓合约 | 📋 | | 获取清算价格 | 📋 | | 设置止损/止盈 | 📋 | | 获取盈亏 | 📋 | | 部分平仓 | 📋 |

期权

| 功能 | 状态 | |---------|--------| | 买入看涨/看跌期权 | 📋 | | 卖出/写入期权 | 📋 | | 行使期权 | 📋 | | 获取期权希腊字母 | 📋 | | 获取隐含波动率 | 📋 | | 获取期权链 | 📋 | | 价差策略 | 📋 |

合成资产

| 功能 | 状态 | |---------|--------| | 铸造合成资产 | 📋 | | 燃烧合成资产 | 📋 | | 获取抵押率 | 📋 | | 获取合成价格馈送 | 📋 | | 清算合成头寸 | 📋 |

🌉 跨链与桥接

桥接

| 功能 | 状态 | |---------|--------| | 跨链桥接代币 | ✅ | | 获取桥接报价 | ✅ | | 获取桥接状态 | ✅ | | 获取支持的链 | ✅ | | 获取支持的代币 | ✅ | | 领取桥接代币 | 📋 | | 获取桥接费用 | ✅ | | 获取估计时间 | ✅ |

跨链消息传递

| 功能 | 状态 | |---------|--------| | 发送跨链消息 | 📋 | | 接收跨链消息 | 📋 | | LayerZero 操作 | 📋 | | Axelar 操作 | 📋 | | Wormhole 操作 | 📋 | | CCIP（Chainlink） | 📋 | | Hyperlane 操作 | 📋 |

原子交换

| 功能 | 状态 | |---------|--------| | 发起原子交换 | 📋 | | 完成原子交换 | 📋 | | 退还原子交换 | 📋 |

🗳️ 治理

投票

| 功能 | 状态 | |---------|--------| | 创建提案 | ✅ | | 对提案投票 | ✅ | | 委托投票 | ✅ | | 获取投票权 | ✅ | | 获取提案状态 | ✅ | | 排队提案 | ✅ | | 执行提案 | ✅ | | 取消提案 | ✅ | | 获取投票收据 | ✅ |

代币锁定

| 功能 | 状态 | |---------|--------| | 锁定代币用于投票（veTokens） | 📋 | | 延长锁定周期 | 📋 | | 增加锁定金额 | 📋 | | 提取解锁的代币 | 📋 | | 获取锁定信息 | 📋 |

Snapshot（链下）

| 功能 | 状态 | |---------|--------| | 创建空间 | 📋 | | 创建链下提案 | 📋 | | 链下投票 | 📋 | | 获取 Snapshot 结果 | 📋 |

🔐 安全与分析

合约分析

| 功能 | 状态 | |---------|--------| | 验证合约源代码 | ✅ | | 获取合约 ABI | ✅ | | 检查合约是否为代理 | ✅ | | 获取实现地址 | ✅ | | 检测蜜罐 | ✅ | | 检查拉地毯风险 | ✅ | | GoPlus 代币安全检查 | ✅ | | GoPlus 拉地毯检测 | ✅ | | 审计分数 | 📋 | | 获取合约创建者 | ✅ | | 获取合约年龄 | ✅ | | 检测恶意函数 | ✅ |

代币安全

| 功能 | 状态 | |---------|--------| | 检查代币安全性 | ✅ | | 获取持有者分布 | ✅ | | 检查是否可铸造 | ✅ | | 检查是否可暂停 | ✅ | | 检查隐藏费用 | ✅ | | 检查流动性锁定 | ✅ | | 获取前持有者 | ✅ | | 检查所有权是否放弃 | ✅ | | GoPlus NFT 安全 | ✅ | | GoPlus 批准安全 | ✅ |

钱包安全

| 功能 | 状态 | |---------|--------| | 获取批准列表 | ✅ | | 撤销批准 | ✅ | | 检查漏洞利用者 | ✅ | | 模拟交易安全性 | ✅ | | 获取钱包风险评分 | 📋 | | GoPlus 地址安全 | ✅ | | GoPlus dApp 钓鱼检查 | ✅ | | GoPlus 签名解码 | ✅ |

📈 价格与市场数据

价格馈送

| 功能 | 状态 | |---------|--------| | 获取当前价格 | ✅ | | 获取历史价格 | ✅ | | 获取 OHLCV 数据 | ✅ | | 从 DEX 获取价格 | ✅ | | 从预言机（Chainlink、Pyth）获取价格 | ✅ | | 获取时间加权平均价格（TWAP） | ✅ | | 获取跨交易所价格 | ✅ | | 获取交易量 | ✅ | | 获取市值 | ✅ | | 获取热门代币 | ✅ | | 通过合约地址获取代币 | ✅ | | 获取汇率 | ✅ | | 获取代币类别 | ✅ | | 获取衍生品数据 | ✅ | | 获取公司 BTC/ETH 持有量 | ✅ |

分析

| 功能 | 状态 | |---------|--------| | 获取总锁定价值（TVL） | ✅ | | 获取协议指标 | ✅ | | 获取收益 farming APY | ✅ | | 获取燃气跟踪器 | ✅ | | 获取鲸鱼交易 | 📋 | | 获取代币流动分析 | 📋 | | 获取 DEX 交易量 | ✅ | | 获取借贷指标 | 📋 | | 获取 DeFi 费用和收入 | ✅ | | 获取稳定币数据 | ✅ | | 获取桥接交易量 | ✅ | | 获取清算数据 | ✅ | | 获取 DeFi 黑客攻击历史 | ✅ | | 获取永续合约数据 | ✅ |

🆔 身份与域名

ENS（以太坊名称服务）

| 功能 | 状态 | |---------|--------| | 注册域名 | ✅ | | 将名称解析为地址 | ✅ | | 将地址反向解析为名称 | ✅ | | 设置主名称 | 📋 | | 设置记录（文本、地址、内容哈希） | ✅ | | 转移域名 | ✅ | | 续费域名 | ✅ | | 获取到期日期 | 📋 | | 设置子域名 | ✅ |

其他名称服务

| 功能 | 状态 | |---------|--------| | Unstoppable Domains | 📋 | | Space ID (.bnb) | 📋 | | Bonfida (.sol) | 📋 | | ANS (.avax) | 📋 |

DIDs 与可验证凭证

| 功能 | 状态 | |---------|--------| | 创建 DID | 📋 | | 解析 DID | 📋 | | 颁发可验证凭证 | 📋 | | 验证凭证 | 📋 | | 撤销凭证 | 📋 |

🖼️ NFT 与元宇宙

NFT 市场

| 功能 | 状态 | |---------|--------| | 列出 NFT 待售 | 📋 | | 购买 NFT | 📋 | | 出价 | 📋 | | 接受出价 | 📋 | | 取消列表 | 📋 | | 拍卖 NFT | 📋 | | 参与拍卖出价 | 📋 | | 获取地板价 | 📋 | | 获取集合统计信息 | 📋 |

NFT 创建

| 功能 | 状态 | |---------|--------| | 部署 NFT 集合 | 📋 | | 铸造 NFT | 📋 | | 设置版税 | 📋 | | 设置元数据 | 📋 | | 揭示 NFT | 📋 | | 白名单管理 | 📋 | | 空投 NFT | 📋 |

NFT 金融

| 功能 | 状态 | |---------|--------| | NFT 抵押借贷 | 📋 | | NFT 碎片化 | 📋 | | NFT 租赁 | 📋 | | NFT 质押 | 📋 |

元宇宙

| 功能 | 状态 | |---------|--------| | 购买虚拟土地 | 📋 | | 出售虚拟土地 | 📋 | | 在土地上建造 | 📋 | | 在元宇宙之间转移资产 | 📋 |

🔔 事件与订阅

事件监听

| 功能 | 状态 | |---------|--------| | 订阅合约事件 | 📋 | | 订阅待处理交易 | 📋 | | 订阅新区块 | 📋 | | 订阅日志 | 📋 | | 按主题过滤事件 | ✅ | | 获取历史事件 | ✅ | | 解码事件日志 | ✅ |

Webhook 与通知

| 功能 | 状态 | |---------|--------| | 设置事件 Webhook | 📋 | | 获取交易通知 | 📋 | | 获取价格警报 | 📋 | | 获取鲸鱼警报 | 📋 | | 获取治理通知 | 📋 |

📜 智能合约交互

读取操作

| 功能 | 状态 | |---------|--------| | 调用视图/纯函数 | ✅ | | 获取插槽处的存储 | ✅ | | 获取合约字节码 | ✅ | | 多调用（批量读取） | ✅ | | 静态调用模拟 | ✅ |

写入操作

| 功能 | 状态 | |---------|--------| | 向合约发送交易 | ✅ | | 编码函数调用 | ✅ | | 解码函数结果 | ✅ | | 估算调用燃气 | ✅ | | 批量交易 | ✅ |

合约部署

| 功能 | 状态 | |---------|--------| | 部署合约 | ✅ | | 使用 CREATE2 部署 | ✅ | | 部署代理合约 | ✅ | | 升级代理 | ✅ | | 在浏览器上验证 | ✅ |

🤖 高级功能

MEV 与 Flashbots

| 功能 | 状态 | |---------|--------| | 提交私密交易 | ✅ | | 提交交易包 | ✅ | | 获取 MEV 机会 | ✅ | | 后运行保护 | ✅ | | 前运行保护 | ✅ | | 三明治保护 | ✅ |

账户抽象（ERC - 4337）

| 功能 | 状态 | |---------|--------| | 创建智能账户 | 📋 | | 执行用户操作 | 📋 | | 批量操作 | 📋 | | 赞助燃气（Paymaster） | 📋 | | 会话密钥 | 📋 | | 社交恢复 | 📋 |

意图与求解器

| 功能 | 状态 | |---------|--------| | 提交意图 | 📋 | | 获取求解器报价 | 📋 | | 通过求解器执行 | 📋 |

预言机

| 功能 | 状态 | |---------|--------| | 获取 Chainlink 价格 | ✅ | | 获取 Pyth 价格 | 📋 | | 获取 Band Protocol 价格 | 📋 | | 获取 API3 价格 | 📋 | | 请求随机数（VRF） | 📋 | | 请求外部数据 | 📋 |

🛠️ 实用函数

燃气

| 功能 | 状态 | |---------|--------| | 获取燃气价格 | ✅ | | 获取优先费用 | ✅ | | 获取基础费用 | ✅ | | 获取燃气历史 | ✅ | | 估算交易燃气 | ✅ | | 获取 EIP - 1559 费用 | ✅ |

编码/解码

| 功能 | 状态 | |---------|--------| | ABI 编码 | ✅ | | ABI 解码 | ✅ | | Keccak256 哈希 | ✅ | | 打包/解包数据 | ✅ | | 签署类型化数据（EIP - 712） | ✅ |

地址实用工具

| 功能 | 状态 | |---------|--------| | 验证地址 | ✅ | | 校验和地址 | ✅ | | 从 ENS 获取地址 | ✅ | | 检查是否为合约 | ✅ | | 获取合约类型 | 📋 |

📰 数据与信息

新闻与社交

| 功能 | 状态 | |---------|--------| | 获取加密新闻 | ✅ | | 搜索加密新闻 | ✅ | | 获取 DeFi 新闻 | ✅ | | 获取比特币新闻 | ✅ | | 获取突发新闻 | ✅ | | 获取社交情绪 | ✅ | | 获取影响者排名 | ✅ | | 获取热门话题 | ✅ | | 获取代币社交指标 | ✅ | | 获取社交动态 | ✅ | | 获取市场情绪指数 | ✅ | | 获取银河分数 | ✅ | | 获取 AltRank | ✅ | | 获取 Twitter 提及 | 📋 | | 获取 Discord 活动 | 📋 | | 获取 GitHub 活动 | 📋 |

链上数据

| 功能 | 状态 | |---------|--------| | 获取代币持有者 | 📋 | | 获取鲸鱼钱包 | 📋 | | 获取聪明资金流动 | 📋 | | 获取协议用户 | 📋 | | 获取每日活跃地址 | 📋 | | 获取网络哈希率 | 📋 |

🏛️ 机构与合规

KYC/AML

| 功能 | 状态 | |---------|--------| | 钱包筛查 | 📋 | | 交易监控 | 📋 | | 风险评分 | 📋 | | 制裁检查 | 📋 |

托管

| 功能 | 状态 | |---------|--------| | 多签操作 | 📋 | | 冷存储 | 📋 | | 热钱包管理 | 📋 | | 策略执行 | 📋 |

报告

| 功能 | 状态 | |---------|--------| | 税务报告 | 📋 | | 投资组合跟踪 | ✅ | | 盈亏报告 | 📋 | | 交易历史导出 | 📋 |

🔗 相关 MCP 服务器

此工作区中的其他专业 MCP 服务器： | 服务器 | 描述 | 工具 | |--------|-------------|-------| | binance-mcp-server | 币安全球交易所 API | 156 + 工具 | | binance-us-mcp-server | 币安美国交易所 API | 71 + 工具 |

币安全球服务器

涵盖完整的币安全球 API，包括：

现货交易、钱包、质押、挖矿
兑换、简单收益、算法交易（TWAP/VP）
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"
      }
    }
  }
}

币安美国服务器

美国监管的交易所，提供：

市场数据、现货交易、钱包
质押、场外交易、子账户
托管解决方案（机构）

{
  "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"
      }
    }
  }
}

🤝 贡献

我们欢迎贡献！以下是开始的步骤：

开发设置

# 分叉并克隆
git clone https://github.com/YOUR_USERNAME/bnb-chain-mcp
cd bnb-chain-mcp

# 安装依赖
bun install

# 创建功能分支
git checkout -b feature/amazing-feature

# 进行更改并测试
bun dev
bun test

# 提交并推送
git commit -m "feat: add amazing feature"
git push origin feature/amazing-feature

# 打开拉取请求

贡献指南

📝 遵循现有的代码风格。
✅ 为新功能添加测试。
📖 更新文档。
🔍 在提交前运行代码检查。

添加新工具

在 src/tools/<category>/ 中创建工具文件。
导出带有 Zod 模式的工具定义。
添加到工具索引中。
在 README 中记录。

📄 许可证

本项目采用 MIT 许可证 - 详情请参阅 LICENSE 文件。

🙏 致谢

由 nich（github.com/nirholas）构建。

特别感谢

Model Context Protocol 团队
viem 提供出色的 EVM 工具
所有出色的 Web3 API 提供商

🌟 在 GitHub 上给我们点个星吧！

如果您觉得这个项目有用，请考虑给它一个 ⭐️

为 Web3 和 AI 社区用心打造

_{赋能 AI 代理与区块链交互}