网关3-MCP

Name: 网关3-MCP
Author: strangelove-ventures

作者：strangelove-ventures89 星标更新：2025-03-19

安装使用来源：spider==github.com

项目介绍

技术文档摘要

Web3 MCP

这是一个用于与多个区块链（包括Solana、Ethereum、THORChain、XRP Ledger、TON (The Open Network)、Cardano以及UTXO链）交互的Model-Context-Protocol服务器。该服务器提供了简单的RPC端点，用于常见的区块链操作，通过环境变量实现与各种区块链的安全交互。

功能

Solana 操作：

检查SOL账户余额
获取详细的账户信息
在账户之间转移SOL
查看SPL代币余额
从私钥获取钱包地址
使用Jupiter交换代币（在所有Solana DEX中提供最佳价格路由）

Ethereum及EVM链操作：

跨多个网络检查原生代币余额
检查ERC-20代币余额
发送原生代币（使用来自.env文件的私钥）
发送ERC-20代币（使用来自.env文件的私钥）
批准ERC-20代币支出（使用来自.env文件的私钥）

Cardano操作：

获取网络信息和统计数据
检查地址余额和交易历史
查看地址的UTxOs
探索质押池和委托信息
获取关于原生资产的详细信息
查看详细的交易信息
获取当前纪元的统计数据

THORChain操作：

检查RUNE余额
获取详细的池子信息
获取任何支持资产之间的交换报价
通过THORChain协议进行跨链交换

UTXO链操作：

Bitcoin (BTC)
- 检查地址余额
- 查看交易历史
- 验证地址
- 获取网络信息和费用
Litecoin (LTC)
- 检查地址余额
- 查看交易历史
- 验证地址
- 获取网络信息和费用
Dogecoin (DOGE)
- 检查地址余额
- 查看交易历史
- 验证地址
- 获取网络信息和费用
Bitcoin Cash (BCH)
- 检查地址余额
- 查看交易历史
- 验证地址
- 获取网络信息和费用

XRP Ledger操作：

检查XRP账户余额
查看交易历史
验证XRP地址
将XRP发送到另一个地址
获取当前XRP Ledger的信息
检查代币余额
创建代币的信任线

TON (The Open Network)操作：

获取TON账户余额
查看交易历史
验证TON地址
将TON发送到另一个地址，并可选添加备注/评论
获取当前TON网络的信息

支持的EVM网络：

Ethereum
Base
Arbitrum
Optimism
BSC (Binance Smart Chain)
Polygon
Avalanche
Berachain

设置

克隆并安装依赖项：

git clone https://github.com/strangelove-ventures/web3-mcp.git
cd web3-mcp
npm install

cp .env.example .env

在.env文件中配置您的环境变量：

必要配置

# 工具注册控制
ENABLE_SOLANA_TOOLS=true      # 启用/禁用Solana工具
ENABLE_ETHEREUM_TOOLS=true    # 启用/禁用Ethereum和EVM链工具
ENABLE_CARDANO_TOOLS=true     # 启用/禁用Cardano工具

# UTXO链工具
ENABLE_BITCOIN_TOOLS=true     # 启用/禁用Bitcoin工具
ENABLE_LITECOIN_TOOLS=true    # 启用/禁用Litecoin工具
ENABLE_DOGECOIN_TOOLS=true    # 启用/禁用Dogecoin工具
ENABLE_BITCOINCASH_TOOLS=true # 启用/禁用Bitcoin Cash工具
ENABLE_THORCHAIN_TOOLS=true   # 启用/禁用THORChain工具
ENABLE_RIPPLE_TOOLS=true      # 启用/禁用XRP Ledger工具
ENABLE_TON_TOOLS=true         # 启用/禁用TON工具

# 私钥（用于交易）
ETH_PRIVATE_KEY=your-ethereum-private-key
SOLANA_PRIVATE_KEY=your-base58-encoded-solana-private-key

# XRP Ledger凭证（用于XRP交易）
# 需要私钥或助记词中的一个
XRP_PRIVATE_KEY=your-xrp-private-key-in-hex
# 或者
XRP_MNEMONIC=your-xrp-mnemonic-recovery-phrase
# 可选 - 用于验证派生地址
XRP_ADDRESS=your-xrp-account-address

# TON配置
TON_MNEMONIC=word1 word2 word3 ... word24  # 用于TON钱包的24个单词恢复短语
TON_ADDRESS=your-ton-wallet-address       # 您的TON钱包地址
TON_API_KEY=your-toncenter-api-key        # 从Telegram上的@tonapibot获取（可选但推荐）
TON_RPC_URL=https://toncenter.com/api/v2/jsonRPC  # 可选 - 默认是TON Center API

# Cardano配置
BLOCKFROST_API_KEY=your-blockfrost-api-key  # 从https://blockfrost.io/获取真实的API密钥
CARDANO_NETWORK=mainnet     # 或'testnet'，'preview'，'preprod'
CARDANO_MNEMONIC=your-cardano-mnemonic-phrase   # 用于交易签名的助记词
CARDANO_ACCOUNT_INDEX=0     # 可选 - 默认为0

可选配置

# 网络RPC URL（可选 - 如果未指定，则使用公共端点）
SOLANA_RPC_URL=https://api.mainnet-beta.solana.com

# Ethereum及Layer 2
ETH_RPC_URL=https://eth-mainnet.g.alchemy.com/v2/your-api-key
ARBITRUM_RPC_URL=https://arb1.arbitrum.io/rpc
BASE_RPC_URL=https://mainnet.base.org
OPTIMISM_RPC_URL=https://mainnet.optimism.io

# 其他EVM链
BSC_RPC_URL=https://bsc-dataseed.binance.org
POLYGON_RPC_URL=https://polygon-rpc.com
AVALANCHE_RPC_URL=https://api.avax.network/ext/bc/C/rpc
BERACHAIN_RPC_URL=https://rpc.berachain.com

# XRP Ledger
XRP_RPC_URL=https://xrplcluster.com/     # 可选 - 如果未指定，则使用公共端点

# TON网络
TON_RPC_URL=https://toncenter.com/api/v2/jsonRPC  # 可选 - 默认是TON Center API
TON_API_KEY=your-toncenter-api-key        # 从Telegram上的@tonapibot获取（可选但推荐）

# THORChain配置
THORCHAIN_NODE_URL=https://thornode.ninerealms.com  # 可选 - 如果未指定，则使用公共端点
THORCHAIN_PRIVATE_KEY=your-thorchain-private-key
THORCHAIN_MNEMONIC=your-thorchain-mnemonic

# UTXO链API密钥（可选）
BLOCKCYPHER_API_KEY=your-blockcypher-api-key
SOCHAIN_API_KEY=your-sochain-api-key

构建工具：

npm run build

将工具添加到您的claude_desktop_config.json：

{
  "mcpServers": {
    "web3-rpc": {
      "command": "node",
      "args": [
        "/PATH/TO/web3-mcp/build/index.js"
      ]
    }
  }
}

工具注册

Web3 MCP服务器允许您通过环境变量来控制哪些区块链工具被注册：

ENABLE_SOLANA_TOOLS：启用/禁用Solana工具
ENABLE_ETHEREUM_TOOLS：启用/禁用Ethereum和EVM链工具
ENABLE_BITCOIN_TOOLS：启用/禁用Bitcoin工具
ENABLE_LITECOIN_TOOLS：启用/禁用Litecoin工具
ENABLE_DOGECOIN_TOOLS：启用/禁用Dogecoin工具
ENABLE_BITCOINCASH_TOOLS：启用/禁用Bitcoin Cash工具
ENABLE_THORCHAIN_TOOLS：启用/禁用THORChain工具
ENABLE_RIPPLE_TOOLS：启用/禁用XRP Ledger工具
ENABLE_CARDANO_TOOLS：启用/禁用Cardano工具
ENABLE_TON_TOOLS：启用/禁用TON工具

在您的.env文件中将这些变量设置为true或false以控制哪些工具对服务器可用。这允许您：

通过仅加载所需工具来减少启动时间
通过禁用未使用的链来最小化安全表面区域
根据特定用途定制服务器
通过限制活动连接来控制资源使用

使用示例

询问Claude（或您选择的MCP客户端）：

Solana操作（当`ENABLE_SOLANA_TOOLS=true`时）

"我的Solana地址是什么？" - 显示从.env文件中的私钥派生的地址
"62QXuWZ3WT6ws1ZFxJobVDVXn6bEsiYpLo5yG612U6u3的余额是多少？"
"将0.001 SOL转移到Cg6cVS4tjkxHthm3K9BHhmvqF7kSz8GnXqqYXnHBzGXd"
"显示我的SPL代币余额"
"交换0.1 SOL为USDC"（使用Jupiter进行最佳价格路由）

EVM操作（当`ENABLE_ETHEREUM_TOOLS=true`时）

"0x556437c4d22ceaeeebf82006b85bdcc0ae67d933的ETH余额是多少？"
"检查0x556437c4d22ceaeeebf82006b85bdcc0ae67d933在Ethereum上的USDC余额"
"向0x556437c4d22ceaeeebf82006b85bdcc0ae67d933发送0.1 ETH"
"Arbitrum上的当前gas价格是多少？"
"在Polygon上向0x556437c4d22ceaeeebf82006b85bdcc0ae67d933发送100 USDC"

Cardano操作（当`ENABLE_CARDANO_TOOLS=true`时）

获取任何Cardano的余额
查看您的钱包信息
将ADA发送到另一个地址
将原生代币发送到另一个地址

Bitcoin操作（当`ENABLE_BITCOIN_TOOLS=true`时）

"1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa的BTC余额是多少？"
"显示bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh的交易历史"
"验证这个比特币地址：1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa"

Litecoin操作（当`ENABLE_LITECOIN_TOOLS=true`时）

"LM2WMpR1Rp6j3Sa59cMXMs1SPzj9eXpGc1的LTC余额是多少？"
"显示这个Litecoin地址的交易历史"
"当前Litecoin网络费用是多少？"

Dogecoin操作（当`ENABLE_DOGECOIN_TOOLS=true`时）

"检查这个DOGE地址的余额：D8vFz4p1L37jdg47HXKtSHA5uYLYxbGgPD"
"显示最近的Dogecoin交易"
"当前DOGE网络费用是多少？"

Bitcoin Cash操作（当`ENABLE_BITCOINCASH_TOOLS=true`时）

"这个地址的BCH余额是多少？"
"显示BCH交易历史"
"验证这个Bitcoin Cash地址"

THORChain操作（当`ENABLE_THORCHAIN_TOOLS=true`时）

"thor13zpdckczd0jvyhwxmrwnpap8gmy9m5kk2gzum3的RUNE余额是多少？"
"显示BTC.BTC的池子信息"
"获取0.1 BTC.BTC到ETH.ETH的交换报价"

XRP Ledger操作（当`ENABLE_RIPPLE_TOOLS=true`时）

"rPT1Sjq2YGrBMTttX4GZHjKu9dyfzbpAYe的XRP余额是多少？"
"显示rPT1Sjq2YGrBMTttX4GZHjKu9dyfzbpAYe的交易历史"
"rPT1Sjq2YGrBMTttX4GZHjKu9dyfzbpAYe是一个有效的XRP地址吗？"
"向rPT1Sjq2YGrBMTttX4GZHjKu9dyfzbpAYe发送10 XRP"
"当前XRP Ledger的信息是什么？"
"显示rPT1Sjq2YGrBMTttX4GZHjKu9dyfzbpAYe的代币余额"
"为USD创建一个信任线，发行者为rPT1Sjq2YGrBMTttX4GZHjKu9dyfzbpAYe，限额为1000"

TON操作（当`ENABLE_TON_TOOLS=true`时）

"EQAAFhjXzKuQ5N0c96nsdZQWATcJm909LYSaCAvWFQF8tvUZ的TON余额是多少？"
"显示EQAAFhjXzKuQ5N0c96nsdZQWATcJm909LYSaCAvWFQF8tvUZ的交易历史"
"UQD0BRQt-QdIEbsjuRsMqzDlBkUAEfQixShDECoKEOXRc4eR是一个有效的TON地址吗？"
"向EQAAFhjXzKuQ5N0c96nsdZQWATcJm909LYSaCAvWFQF8tvUZ发送0.1 TON"
"向UQD0BRQt-QdIEbsjuRsMqzDlBkUAEfQixShDECoKEOXRc4eR发送0.01 TON，并附带评论'测试付款'"
"当前TON网络的信息是什么？"

安全注意事项

环境变量：所有私钥都存储在.env文件中，并且永远不会暴露在对话历史记录中
私钥：仅使用包含少量资金的测试钱包
RPC端点：可以在.env文件中配置自定义RPC端点以提高可靠性和速率限制
.env安全性：.env文件会自动被git忽略，以防意外泄露私钥
工具注册：使用工具注册控制来通过仅启用所需的链来最小化安全表面区域

高级配置

自定义RPC端点

您可以在.env文件中配置自定义RPC端点以提高可靠性和更高的速率限制。如果未指定，工具将回退到公共RPC端点。

网络选择

对于EVM操作，您可以按名称指定网络（ethereum、base、arbitrum、optimism、bsc、polygon、avalanche、berachain）。工具将自动使用适当的RPC端点和网络配置。

Cardano配置

该工具使用Blockfrost API和Lucid库与Cardano区块链交互。

BLOCKFROST_API_KEY：必需 - 您的Blockfrost API密钥（在https://blockfrost.io/注册）
CARDANO_NETWORK：可选 - 要使用的Cardano网络（mainnet、testnet、preview、preprod）。默认为'mainnet'
CARDANO_MNEMONIC：必需 - 用于交易的Cardano钱包助记词（15或24个单词）
CARDANO_ACCOUNT_INDEX：可选 - 要使用的账户索引（默认为0）

从您的助记词派生的钱包将用于签名和发送交易。

THORChain配置

该工具默认使用Nine Realms公共端点，但您可以在.env文件中配置自定义THORChain节点URL以提高可靠性和速率限制。

XRP Ledger配置

该工具可以使用私钥或助记词进行XRP交易。在您的.env文件中配置这些内容：

XRP_PRIVATE_KEY：您的XRP私钥（十六进制格式）
XRP_MNEMONIC：私钥的替代方案 - 您的12个单词恢复短语
XRP_ADDRESS：可选 - 您的XRP账户地址（用于验证派生地址）
XRP_RPC_URL：可选 - 自定义XRP Ledger节点URL（默认为公共端点）

TON配置

该工具默认使用TON Center的API，并需要助记词来进行TON交易。在您的.env文件中配置这些内容：

TON_MNEMONIC：必需 - 您的24个单词恢复短语用于TON钱包
TON_ADDRESS：必需 - 您的TON钱包