内容
# 工具列表
## Robinhood Chain EVM Web3 MCP 服务器
一款专为 **Robinhood Chain**（以及一般的 Arbitrum Orbit Layer-2 网络）量身定制的、零依赖、纯 Python 的 **模型上下文协议（MCP）** 服务器。
该服务器充当 Web3/EVM 桥接器，允许本地 AI 代理（例如 Claude、Cursor、Gemini CLI）读取状态、估计 gas、模拟执行并使用简单的 JSON-RPC 工具直接在链上签名和广播交易。
---
## 为什么这很重要
传统开发者进入新启动的区块链（例如 Robinhood Chain，于 2026 年 7 月启动）面临着巨大的摩擦：
1. **上下文窗口膨胀：** 将复杂的、多千行 JSON ABI 传递给 LLM 会浪费代币并导致内存退化。
2. **AI 到 Web3 的差距：** AI 模型无法原生计算 gas、签名交易或验证合约逻辑，而需要大量的样板代码。
该工具解决了这两个问题：
- **简化签名：** 使用本地 SQLite 缓存存储复杂的 ABI，仅向 LLM 公开人类可读的最小签名（例如 `transfer(address,uint256)`）。
- **自主执行：** 允许代理在环境变量中提供私钥时，自主查询、模拟（试运行）、签名和验证交易。
---
## 🚀 为 Arbitrum Open House 开发者补助金进行宣传
Robinhood Chain 已承诺 **100 万美元** 通过 **Arbitrum Open House Program** 支持开发者活动和生态系统增长。
您可以使用此代码库来申请开发者补助金：
1. **Fork/启动此服务器** 作为一个独立的开源开发者工具。
2. **构建演示 dApp/代理** （例如，“Robinhood RWA Portfolio Manager Agent”，它动态地将 USDG 稳定币收益兑换成 AAPL/TSLA 等代币化的股票）。
3. **提交到 Arbitrum / Robinhood Testnet Faucet 和 Open House 程序** 作为一个活跃的基础设施贡献。
---
## 🛠️ 设置说明（Termux / Linux）
### 1. 安装依赖项
```bash
pip install -r requirements.txt
```
### 2. 配置环境变量
创建或更新您的 `~/.env` 文件：
```env
# RPC 覆盖（默认为 Robinhood 主网）
ROBINHOOD_CHAIN_RPC_URL="https://rpc.mainnet.chain.robinhood.com"
# 用于自主交易签名的私钥（请确保安全！）
ROBINHOOD_CHAIN_PRIVATE_KEY="0x..."
```
---
## 🔌 连接到 AI 客户端（MCP 设置）
### 1. Cursor
前往 **设置 > 模型 > MCP** 并添加一个新服务器：
- **名称：** `Robinhood-EVM-MCP`
- **类型：** `command`
- **命令：** `python /data/data/com.termux/files/home/robinhood-evm-mcp/server.py`
### 2. Claude Desktop
将以下内容添加到您的 `claude_desktop_config.json`（通常位于 `~/.config/Claude/claude_desktop_config.json`）：
```json
{
"mcpServers": {
"robinhood-evm-mcp": {
"command": "python",
"args": ["/data/data/com.termux/files/home/robinhood-evm-mcp/server.py"]
}
}
}
```
---
## 🛠️ 公开的 MCP 工具
1. **`get_evm_balance(address, token_address)`**：获取原生 ETH 或 ERC-20 代币余额。支持 ticker 覆盖（`USDG`、`AAPL`、`TSLA` 或动态注册的 ticker）。
2. **`query_smart_contract(contract_address, function_name, args, abi_type)`**：在智能合约上执行只读查询（调用）。
3. **`simulate_evm_transaction(contract_address, function_name, args, value_wei)`**：试运行状态更改交易并返回预估的 gas 详细信息。
4. **`send_evm_transaction(contract_address, function_name, args, value_wei, wait_confirm)`**：构建、签名并广播交易。
5. **`get_robinhood_ticker(ticker)`**：检索代币化股票或 USDG 的已验证合约地址。
6. **`switch_rpc_network(network_name)`**：动态更改活动网络配置（选项：`robinhood-mainnet`、`robinhood-testnet`、`localhost`）。
7. **`register_custom_abi(contract_address, abi_json)`**：将自定义智能合约 ABI 保存到本地 SQLite 数据库映射中。
8. **`scan_launched_tokens(force_refresh)`**：查询 MemeFactory 智能合约以扫描和索引所有已部署的 meme 代币。
9. **`import_custom_token(ticker, address, name, decimals)`**：动态导入自定义地址作为 ticker，并将它们保存到本地 SQLite 缓存中。
10. **`estimate_meme_trade_output(token_address, trade_type, amount)`**：模拟债券曲线交易并计算预期输出金额和价格影响。
11. **`buy_meme_coin(token_address, eth_amount, max_slippage, min_output_amount)`**：执行买入交易，并在飞行前验证具有滑点安全性的链上债券曲线参数。
12. **`sell_meme_coin(token_address, token_amount, max_slippage, min_output_amount)`**：执行卖出交易，并在飞行前验证具有滑点安全性的链上债券曲线参数。
13. **`execute_cross_chain_bridge(src_chain_id, src_token, dest_chain_id, dest_token, amount_raw, recipient)`**：获取跨链交换路由和交易详细信息，然后直接在源 EVM 链上构建、签名和执行桥接交易。
14. **`get_meme_price_chart(token_address, block_range)`**：扫描时间顺序的买入/卖出事件日志并查询当前池储备，以重建任何 meme 代币的历史 OHLC 图表模拟数据。
