Arbilink

ArbiLink — 面向 AI Agent 的 Arbitrum MCP 服务

ArbiLink 是原生的 Model Context Protocol (MCP) 服务，可将 AI Agent 直接连接到 Arbitrum 区块链。Claude、Cursor、Windsurf 及任何兼容 MCP 的 Agent 都可以读取实时链上数据并准备 DeFi 交易，无需编写任何区块链代码。

“你的 AI Agent 对区块链一无所知。ArbiLink 让它看见。”

---

在线端点

接口	URL	协议
原生 MCP	https://arbi-link-challenge.replit.app/mcp	JSON-RPC 2.0 (MCP 2024-11-05)
REST API	https://arbi-link-challenge.replit.app/api/mcp	HTTP
仪表板	https://arbi-link-challenge.replit.app	Web

---

快速开始 — Claude Desktop

添加到你的 claude_desktop_config.json：

{
  "mcpServers": {
    "arbilink": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://arbi-link-challenge.replit.app/mcp"
      ]
    }
  }
}

然后询问 Claude：

• “vitalik.eth 的 Arbitrum 钱包里有什么？”
• “在 GMX 上模拟一笔以 $500 抵押品开立的 10 倍 ETH 多头仓位”
• “准备在 Uniswap V3 上将 1 ETH 兑换为 USDC”
• “Arbitrum 当前的 Gas 价格是多少？”

---

快速开始 — Cursor / Windsurf

添加到你的 MCP 设置中：

{
  "mcpServers": {
    "arbilink": {
      "url": "https://arbi-link-challenge.replit.app/mcp"
    }
  }
}

---

11 个在线工具

读取工具（8 个）— 实时链上数据

工具	描述
get_eth_balance	查询任意 Arbitrum 地址的 ETH 余额
get_token_balance	查询 ERC-20 余额（ARB、USDC、USDT、GMX、LINK、WBTC 等）
get_wallet_portfolio	查看包含 USD 估值和 24 小时变动的完整资产组合
get_transaction	通过哈希解码任意交易
get_gas_price	查询 Arbitrum One 上的实时 Gas 价格
get_block	按区块号或 latest 查询区块数据
get_contract_abi	从 Arbiscan 获取并解码 ABI
get_defi_rates	查询 Aave V3 实时借贷利率

执行工具（3 个）— 在签名前模拟并准备交易

工具	描述
simulate_gmx_open	完整的 GMX V2 永续合约模拟 — 入场价、距清算价的距离、±5/10/20% 情景下的盈亏表、每小时借款费用
prepare_uniswap_swap	Uniswap V3 兑换报价 + 完整的 exactInputSingle 调用数据，可直接提交给 SwapRouter02
get_gmx_position_health	查询任意钱包中当前开启的 GMX V2 仓位 — 仓位规模、未实现盈亏、健康状态（健康 / 有风险 / 危急）

---

工具调用示例

模拟 GMX 仓位

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "simulate_gmx_open",
    "arguments": {
      "indexToken": "ETH",
      "collateralUsd": 500,
      "leverage": 10,
      "direction": "long"
    }
  }
}

**响应包括：**ETH 实时价格、仓位规模、清算价格（含距离百分比）、6 种价格情景下的盈亏、每小时借款费用，以及在 GMX V2 上开立仓位的确切后续步骤。

准备 Uniswap 兑换

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "prepare_uniswap_swap",
    "arguments": {
      "tokenIn": "ETH",
      "tokenOut": "USDC",
      "amountIn": 1.5
    }
  }
}

**响应包括：**实时报价、预估输出、受滑点保护的最低输出、池手续费等级、价格影响、Gas 估算，以及供 SwapRouter02 使用的完整 exactInputSingle 调用数据。

查看钱包资产组合

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "get_wallet_portfolio",
    "arguments": {
      "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
    }
  }
}

---

REST API

所有工具也可通过 HTTP POST 调用：

curl -X POST https://arbi-link-challenge.replit.app/api/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "tool": "get_eth_balance",
    "arguments": { "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045" }
  }'

---

链上 Agent 注册表

ArbiLink 附带一个已部署在 Arbitrum Sepolia 上的 AgentRegistry 智能合约，为 AI Agent 提供可验证的链上身份基础。

• 合约：0x8fb1a3fe1e380b5578918888140a16fa699c85b0（Arbitrum Sepolia）
• Agent 在链上注册其端点、能力和元数据
• 任何客户端都可以无需信任地验证 Agent 的身份和能力
• 可通过 Agent 页面查看

---

支持的代币

ETH、WETH、ARB、USDC、USDT、WBTC、GMX、LINK、DAI、PENDLE、RDNT

支持的 DeFi 协议

• GMX V2 — 永续合约模拟、仓位健康状态
• Uniswap V3 — 准备包含调用数据的兑换
• Aave V3 — 实时借贷利率

---

架构

AI Agent (Claude / Cursor / Windsurf)
         │
         ▼ MCP JSON-RPC 2.0
┌─────────────────────┐
│   ArbiLink Server   │
│   (Node.js/Express) │
├─────────────────────┤
│  11 MCP Tools       │
│  REST API bridge    │
│  AgentRegistry RPC  │
└─────────────────────┘
         │
         ▼
┌─────────────────────┐
│   Arbitrum One      │
│   (live RPC)        │
│   CoinGecko prices  │
│   GMX V2 API        │
│   Arbiscan ABI      │
└─────────────────────┘

---

路线图

• v1.0（已上线） — 8 个读取工具 + 3 个执行工具、AgentRegistry 合约、双 MCP/REST 接口
• v1.1（开发中） — API 密钥认证 + 速率限制、Aave V3 持仓、Uniswap LP 持仓
• v2.0（计划中） — 多 Agent 协调、链上事件的 webhook 订阅
• v3.0（未来） — 通过已连接的钱包签署交易、扩展多链支持

---

许可证

MIT