Web3 MCP

一个用于与包括 Solana、以太坊、THORChain、XRP Ledger、TON (The Open Network)、Cardano 和 UTXO 链在内的多个区块链交互的模型-上下文-协议服务器。该服务器为常见的区块链操作提供简单的 RPC 端点，允许通过环境变量与各种区块链进行安全交互。

<a href="https://glama.ai/mcp/servers/an8x6gmzdn"><img width="380" height="200" src="https://glama.ai/mcp/servers/an8x6gmzdn/badge" alt="Web3 Server MCP server" /></a>

功能

Solana 操作:

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

以太坊 & EVM 链操作:

• 检查多个网络上的原生代币余额
• 检查 ERC-20 代币余额
• 发送原生代币 (使用 .env 中的私钥)
• 发送 ERC-20 代币 (使用 .env 中的私钥)
• 批准 ERC-20 代币支出 (使用 .env 中的私钥)

Cardano 操作:

• 获取网络信息和统计数据
• 检查地址余额和交易历史
• 查看地址的 UTxO
• 探索权益池和委托信息
• 获取有关原生资产的详细信息
• 查看详细的交易信息
• 获取有关当前 epoch 的统计数据

THORChain 操作:

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

UTXO 链操作:

• 比特币 (BTC)
  • 检查地址余额
  • 查看交易历史
  • 验证地址
  • 获取网络信息和费用
• 莱特币 (LTC)
  • 检查地址余额
  • 查看交易历史
  • 验证地址
  • 获取网络信息和费用
• 狗狗币 (DOGE)
  • 检查地址余额
  • 查看交易历史
  • 验证地址
  • 获取网络信息和费用
• 比特币现金 (BCH)
  • 检查地址余额
  • 查看交易历史
  • 验证地址
  • 获取网络信息和费用

XRP Ledger 操作:

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

TON (The Open Network) 操作:

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

支持的 EVM 网络:

• 以太坊
• Base
• Arbitrum
• Optimism
• BSC (币安智能链)
• Polygon
• Avalanche
• Berachain

设置

1. 克隆并安装依赖项:

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

2. 在根目录中创建一个 .env 文件:

cp .env.example .env

3. 在 .env 中配置你的环境变量:

必需配置

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

# UTXO 链工具
ENABLE_BITCOIN_TOOLS=true     # 启用/禁用比特币工具
ENABLE_LITECOIN_TOOLS=true    # 启用/禁用莱特币工具
ENABLE_DOGECOIN_TOOLS=true    # 启用/禁用狗狗币工具
ENABLE_BITCOINCASH_TOOLS=true # 启用/禁用比特币现金工具
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

# 以太坊 & 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

4. 构建工具:

npm run build

5. 将该工具添加到你的 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: 启用/禁用以太坊和 EVM 链工具
• ENABLE_BITCOIN_TOOLS: 启用/禁用比特币工具
• ENABLE_LITECOIN_TOOLS: 启用/禁用莱特币工具
• ENABLE_DOGECOIN_TOOLS: 启用/禁用狗狗币工具
• ENABLE_BITCOINCASH_TOOLS: 启用/禁用比特币现金工具
• 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 时)

• "What's my Solana address?" - 显示从 .env 中的私钥派生的你的地址
• "What's the balance of 62QXuWZ3WT6ws1ZFxJobVDVXn6bEsiYpLo5yG612U6u3?"
• "Transfer 0.001 SOL to Cg6cVS4tjkxHthm3K9BHhmvqF7kSz8GnXqqYXnHBzGXd"
• "Show me my SPL token balances"
• "Swap 0.1 SOL to USDC" (使用 Jupiter 获取最佳价格路由)

EVM 操作 (当 ENABLE_ETHEREUM_TOOLS=true 时)

• "What's the ETH balance of 0x556437c4d22ceaeeebf82006b85bdcc0ae67d933?"
• "Check the USDC balance for 0x556437c4d22ceaeeebf82006b85bdcc0ae67d933 on Ethereum"
• "Send 0.1 ETH to 0x556437c4d22ceaeeebf82006b85bdcc0ae67d933"
• "What's the current gas price on Arbitrum?"
• "Send 100 USDC to 0x556437c4d22ceaeeebf82006b85bdcc0ae67d933 on Polygon"

Cardano 操作 (当 ENABLE_CARDANO_TOOLS=true 时)

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

Bitcoin 操作 (当 ENABLE_BITCOIN_TOOLS=true 时)

• "What's the BTC balance of 1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa?"
• "Show me the transaction history for bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh"
• "Validate this Bitcoin address: 1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa"

Litecoin 操作 (当 ENABLE_LITECOIN_TOOLS=true 时)

• "What's the LTC balance of LM2WMpR1Rp6j3Sa59cMXMs1SPzj9eXpGc1?"
• "Show me the transaction history for this Litecoin address"
• "What's the current Litecoin network fee?"

Dogecoin 操作 (当 ENABLE_DOGECOIN_TOOLS=true 时)

• "Check this DOGE address balance: D8vFz4p1L37jdg47HXKtSHA5uYLYxbGgPD"
• "Show me recent Dogecoin transactions"
• "What are the current DOGE network fees?"

Bitcoin Cash 操作 (当 ENABLE_BITCOINCASH_TOOLS=true 时)

• "What's the BCH balance of this address?"
• "Show me the BCH transaction history"
• "Validate this Bitcoin Cash address"

THORChain 操作 (当 ENABLE_THORCHAIN_TOOLS=true 时)

• "What's the RUNE balance of thor13zpdckczd0jvyhwxmrwnpap8gmy9m5kk2gzum3?"
• "Show me the pool information for BTC.BTC"
• "Get a swap quote for 0.1 BTC.BTC to ETH.ETH"

XRP Ledger 操作 (当 ENABLE_RIPPLE_TOOLS=true 时)

• "What's the XRP balance of rPT1Sjq2YGrBMTttX4GZHjKu9dyfzbpAYe?"
• "Show me the transaction history for rPT1Sjq2YGrBMTttX4GZHjKu9dyfzbpAYe"
• "Is rPT1Sjq2YGrBMTttX4GZHjKu9dyfzbpAYe a valid XRP address?"
• "Send 10 XRP to rPT1Sjq2YGrBMTttX4GZHjKu9dyfzbpAYe"
• "What's the current XRP Ledger information?"
• "Show me token balances for rPT1Sjq2YGrBMTttX4GZHjKu9dyfzbpAYe"
• "Create a trustline for USD with issuer rPT1Sjq2YGrBMTttX4GZHjKu9dyfzbpAYe with a limit of 1000"

TON 操作 (当 ENABLE_TON_TOOLS=true 时)

• "What's the TON balance of EQAAFhjXzKuQ5N0c96nsdZQWATcJm909LYSaCAvWFQF8tvUZ?"
• "Show me the transaction history for EQAAFhjXzKuQ5N0c96nsdZQWATcJm909LYSaCAvWFQF8tvUZ"
• "Is UQD0BRQt-QdIEbsjuRsMqzDlBkUAEfQixShDECoKEOXRc4eR a valid TON address?"
• "Send 0.1 TON to EQAAFhjXzKuQ5N0c96nsdZQWATcJm909LYSaCAvWFQF8tvUZ"
• "Send 0.01 TON to UQD0BRQt-QdIEbsjuRsMqzDlBkUAEfQixShDECoKEOXRc4eR with comment 'test payment'"
• "What's the current TON Network information?"

安全注意事项

1. 环境变量: 所有私钥都存储在 .env 文件中，并且永远不会在对话历史记录中公开
2. 私钥: 仅将其与包含少量资金的测试钱包一起使用
3. RPC 端点: 可以在 .env 文件中配置自定义 RPC 端点，以获得更好的可靠性和速率限制
4. .env 安全性: .env 文件会自动被 git 忽略，以防止意外暴露私钥
5. 工具注册: 使用工具注册控制来最小化安全攻击面，仅启用所需的链

高级配置

自定义 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: 必需 - 你的 TON 钱包的 24 字恢复短语
• TON_ADDRESS: 必需 - 你的 TON 钱包地址
• TON_API_KEY: 推荐 - 来自 Telegram 上的 @tonapibot 的 API 密钥 (用于更高的速率限制)
• TON_RPC_URL: 可选 - 自定义 TON RPC URL (默认为 TON Center API)

该实现包括自动重试逻辑，并具有指数退避，用于速率限制处理。

UTXO 链数据提供商

该工具使用多个数据提供商来处理 UTXO 链:

• BlockCypher
• SoChain
• Haskoin (用于比特币现金)

你可以在 .env 文件中配置这些提供商的 API 密钥，以获得更好的速率限制。

开发

要修改或扩展该工具:

1. 源代码位于 src 目录中
2. 链特定代码位于 src/chains 中
3. 更改后运行 npm run build
4. 对所有新代码使用 TypeScript

贡献

欢迎贡献! 请提交包含任何改进或错误修复的拉取请求。

许可证

ISC 许可证