Blockchain Payment

区块链支付MCP服务器

基于Base网络的区块链支付MCP（Model Context Protocol）服务器，提供完整的区块链支付功能。

🌟 功能特性

• 多网络支持: 支持多个测试网和主网，包括Base Sepolia、Base Mainnet、Ethereum Sepolia、Ethereum Mainnet等
• 代币支持: ETH、USDC、USDT、DAI、WETH等主流代币
• 余额查询: 查询任意地址的ETH和代币余额
• 安全转账: 支持ETH和ERC20代币转账
• 交易追踪: 实时查询交易状态和确认数
• Gas估算: 智能估算交易Gas费用
• 钱包管理: 创建新钱包、验证地址格式
• 安全限制: 内置交易金额限制和安全检查

🚀 快速开始

1. 安装MCP包

pip install blockchain-payment-mcp

2. MCP配置文件

项目根目录的 mcp_config.json 文件已经配置好了MCP服务器：

{
  "mcpServers": {
    "blockchain-payment": {
      "command": "blockchain-payment-mcp",
      "args": [],
      "env": {
        "PRIVATE_KEY": "your-private-key-here",
        "DEFAULT_NETWORK": "base_sepolia",
        "DEBUG": "true",
        "MAX_TRANSACTION_VALUE": "10",
        "PYTHONPATH": "."
      }
    }
  }
}

3. 环境变量配置

在 mcp_config.json 中配置以下环境变量：

• PRIVATE_KEY: 你的私钥（用于发送交易）
• DEFAULT_NETWORK: 默认网络（base_sepolia, ethereum_mainnet 等）
• DEBUG: 调试模式（true/false）
• MAX_TRANSACTION_VALUE: 最大交易金额限制

支持的MCP工具

余额和查询工具

1. get_balance - 查询指定地址的余额

   • 参数: address (必需), token_symbol (可选), network (可选)

2. get_network_info - 获取当前网络信息

   • 参数: network (可选)

3. get_supported_tokens - 获取支持的代币列表

   • 参数: random_string (必需，用于无参数工具)

4. validate_address - 验证以太坊地址格式

   • 参数: address (必需)

交易工具

5. send_transaction - 发送代币转账交易

   • 参数: to_address (必需), amount (必需), token_symbol (可选), network (可选)

6. get_transaction_status - 查询交易状态和详情

   • 参数: tx_hash (必需), network (可选)

7. estimate_gas_fees - 估算Gas费用

   • 参数: to_address (可选), amount (可选), token_symbol (可选), network (可选)

钱包管理工具

8. create_wallet - 创建新的钱包地址和私钥

   • 参数: label (可选)

9. set_user_wallet - 设置用户钱包私钥

   • 参数: private_key (必需), label (可选)

10. list_wallets - 列出所有已添加的钱包

    • 参数: random_string (必需)

11. switch_wallet - 切换当前使用的钱包

    • 参数: label (必需)

12. remove_wallet - 移除指定标签的钱包

    • 参数: label (必需)

支持的网络

• base_sepolia - Base Sepolia 测试网
• base_mainnet - Base 主网
• ethereum_mainnet - 以太坊主网
• ethereum_sepolia - 以太坊 Sepolia 测试网
• bsc_mainnet - BSC 主网
• bsc_testnet - BSC 测试网
• polygon_mainnet - Polygon 主网
• polygon_amoy - Polygon Amoy 测试网
• avalanche_mainnet - Avalanche 主网
• avalanche_fuji - Avalanche Fuji 测试网
• solana_mainnet - Solana 主网
• solana_devnet - Solana 开发网

支持的代币

• ETH - 以太币
• USDC - USD Coin
• USDC_BASE - Base 网络上的 USDC
• USDC_BSC - BSC 网络上的 USDC
• USDC_POLYGON - Polygon 网络上的 USDC
• DAI - Dai 稳定币
• DAI_BASE - Base 网络上的 DAI
• DAI_BSC - BSC 网络上的 DAI
• DAI_POLYGON - Polygon 网络上的 DAI
• WETH - Wrapped Ether
• WETH_BASE - Base 网络上的 WETH

本地下载代码

1. 安装依赖

pip install -r requirements.txt

2. 环境配置

# 私钥（用于发送交易，可选）
PRIVATE_KEY=your_private_key_here

# 默认网络（默认为base_sepolia）
DEFAULT_NETWORK=base_sepolia

# 最大交易金额限制（默认10 ETH）
MAX_TRANSACTION_VALUE=10

# 调试模式
DEBUG=false

3. 本地代码-配置MCP客户端

在Cursor的mcp.json中添加：

{
  "mcpServers": {
    "blockchain-payment": {
      "command": "python",
      "args": ["-m", "blockchain_payment_mcp.server"],
      "env": {
        "PRIVATE_KEY": "your_private_key_here",
        "DEFAULT_NETWORK": "base_sepolia",
        "DEBUG": "false",
        "MAX_TRANSACTION_VALUE": "10"
      },
      "cwd": "/path/to/blockmcp"
    }
  }
}

4. 测试服务器

## 🛠️ 可用工具

### `get_balance`
查询指定地址的余额

**参数:**
- `address`: 钱包地址（必需）
- `token_symbol`: 代币符号，如"USDC"、"DAI"（可选）
- `network`: 网络名称（可选，默认base_sepolia）

**示例:**
```python
# 查询ETH余额
{"address": "0x742d..."}

# 查询USDC余额
{"address": "0x742d...", "token_symbol": "USDC"}

send_transaction

发送代币转账交易

参数:

• to_address: 接收方地址（必需）
• amount: 转账金额（必需）
• token_symbol: 代币符号（可选，默认"ETH"）
• network: 网络名称（可选）
• private_key: 发送方私钥（可选，如未提供则使用环境变量）

示例:

# 发送0.01 ETH
{"to_address": "0x...", "amount": "0.01"}

# 发送100 USDC
{"to_address": "0x...", "amount": "100", "token_symbol": "USDC"}

get_transaction_status

查询交易状态

参数:

• tx_hash: 交易哈希（必需）
• network: 网络名称（可选）

estimate_gas_fees

估算Gas费用

参数:

• to_address: 接收方地址（可选）
• amount: 转账金额（可选）
• token_symbol: 代币符号（可选）
• network: 网络名称（可选）

create_wallet

创建新的钱包地址和私钥

参数: 无

get_network_info

获取当前网络信息

参数:

• network: 网络名称（可选）

get_supported_tokens

获取支持的代币列表

参数: 无

validate_address

验证以太坊地址格式

参数:

• address: 要验证的地址（必需）

🌐 支持的网络

Base Sepolia (测试网)

• Chain ID: 84532
• RPC: https://base-sepolia-rpc.publicnode.com
• 浏览器: https://sepolia.basescan.org
• 原生代币: ETH

Base Mainnet (主网)

• Chain ID: 8453
• RPC: https://base-rpc.publicnode.com
• 浏览器: https://basescan.org
• 原生代币: ETH

Ethereum Sepolia (测试网)

• Chain ID: 11155111
• RPC: https://ethereum-sepolia-rpc.publicnode.com
• 浏览器: https://sepolia.etherscan.io
• 原生代币: ETH

Ethereum Mainnet (主网)

• Chain ID: 1
• RPC: https://ethereum-rpc.publicnode.com
• 浏览器: https://etherscan.io
• 原生代币: ETH

BSC Testnet (测试网)

• Chain ID: 97
• RPC: https://bsc-testnet-rpc.publicnode.com
• 浏览器: https://testnet.bscscan.com
• 原生代币: BNB

BSC Mainnet (主网)

• Chain ID: 56
• RPC: https://bsc-rpc.publicnode.com
• 浏览器: https://bscscan.com
• 原生代币: BNB

Polygon Amoy (测试网)

• Chain ID: 80002
• RPC: https://polygon-amoy-rpc.publicnode.com
• 浏览器: https://amoy.polygonscan.com
• 原生代币: MATIC

Polygon Mainnet (主网)

• Chain ID: 137
• RPC: https://polygon-rpc.com
• 浏览器: https://polygonscan.com
• 原生代币: MATIC

Avalanche Fuji (测试网)

• Chain ID: 43113
• RPC: https://avalanche-fuji-c-chain-rpc.publicnode.com
• 浏览器: https://testnet.snowtrace.io
• 原生代币: AVAX

Avalanche Mainnet (主网)

• Chain ID: 43114
• RPC: https://avalanche-c-chain-rpc.publicnode.com
• 浏览器: https://snowtrace.io
• 原生代币: AVAX

🔒 安全特性

1. 交易限制: 内置最大交易金额限制（默认10 ETH）
2. 地址验证: 严格验证所有以太坊地址格式
3. 私钥保护: 支持环境变量和可选私钥传入
4. 错误处理: 完善的异常处理和错误信息
5. 日志记录: 详细的操作日志和调试信息

🧪 测试

运行测试脚本验证功能：

python test_mcp.py

测试包括：

• 配置加载测试
• 网络连接测试
• 钱包功能测试
• 地址验证测试
• Gas估算测试

📝 示例用法

在AI对话中使用

请帮我查询地址 0x742d... 的USDC余额

请发送0.001 ETH到地址 0x123456789...

请查询交易 0xabcdef... 的状态

在测试链上进行操作

请在Base Sepolia测试网上查询地址 0x742d35cc6585c5d74b3c9e5c29ae4eeaae27b76d 的ETH余额

请在Ethereum Sepolia测试网上发送0.001 ETH到地址 0x1234567890123456789012345678901234567890

程序化使用

# 直接调用MCP工具
from blockchain_payment_mcp.server import handle_get_balance

result = await handle_get_balance({
    "address": "0x742d35cc6585c5d74b3c9e5c29ae4eeaae27b76d",
    "token_symbol": "USDC",
    "network": "ethereum_sepolia"
})
print(result)

🔧 开发

项目结构

blockmcp/
├── blockchain_payment_mcp/
│   ├── __init__.py
│   ├── server.py          # MCP服务器主文件
│   ├── blockchain.py      # 区块链交互层
│   ├── wallet.py          # 钱包和签名器
│   └── config.py          # 配置管理
├── requirements.txt       # Python依赖
├── pyproject.toml        # 项目配置
├── test_mcp.py           # 测试脚本
└── README.md             # 说明文档

🧪 测试链支持

本系统支持在多个测试链上进行支付操作，包括:

1. Ethereum Sepolia (ETH)
2. Base Sepolia (ETH)
3. BSC Testnet (BNB)
4. Polygon Amoy (MATIC)
5. Avalanche Fuji (AVAX)

获取测试代币

要获取测试链上的代币用于测试，请访问相应的水龙头:

1. Ethereum Sepolia:

   • https://sepoliafaucet.com/
   • https://www.infura.io/faucet/sepolia

2. Base Sepolia:

   • https://base.org/faucet

3. BSC Testnet:

   • https://testnet.bnbchain.org/faucet-smart

4. Polygon Amoy:

   • https://tools.polygon.technology/faucet/

5. Avalanche Fuji:

   • https://faucet.avax-test.network/

测试链注意事项

1. 测试链上的代币没有实际价值，仅用于开发和测试目的
2. 测试链的Gas价格通常比主网低得多
3. 不同测试链可能有不同的区块时间和确认时间
4. 测试链可能会重置，导致测试资产丢失

🤝 贡献

欢迎提交Issue和Pull Request！

📄 许可证

MIT License

⚠️ 免责声明

本软件仅用于教育和开发目的。使用前请充分测试，作者不承担任何资金损失责任。在主网使用前请确保充分的安全测试。