MCP 服务器
Hyperdrome MCP 服务器在路线图中,尚未上线。本页记录了计划中的规格。
什么是 MCP?
Model Context Protocol (MCP) 是 Anthropic 推出的开放标准,允许 AI 助手发现并调用外部服务器上的工具。它使用 JSON-RPC 2.0 — 助手调用 tools/list 发现可用操作,然后调用 tools/call 执行它们。
MCP 已被 Claude Desktop、Cursor、Opencode、Windsurf 以及越来越多的 AI 编程和聊天工具支持。
为什么将 MCP 用于 DeFi?
目前,与 DeFi 交互需要:
- 打开浏览器
- 连接钱包
- 在复杂的 UI 中导航
- 理解滑点、路由、Gas
通过 Hyperdrome 的 MCP 服务器,任何 AI 助手都可以直接兑换代币、查看收益、投票给 gauge、管理仓位 — 用户无需离开他们偏好的工具。
“在 Hyperdrome 上将 500 USDC 兑换为 HYPE” — 在 Claude Desktop、Cursor 或任何 MCP 客户端中输入即可。
可用工具
MCP 服务器将完整的 Hyperdrome 协议暴露为可调用工具:
Trading
| Tool | Description | Parameters |
|---|
swap | Swap tokens with optimized multi-hop routing | fromToken, toToken, amount, slippageBps? |
get_quote | Get a swap quote without executing | fromToken, toToken, amount |
Liquidity
| Tool | Description | Parameters |
|---|
add_liquidity | Deposit token pair into a pool | tokenA, tokenB, amountA, amountB, stable |
remove_liquidity | Withdraw from a pool | tokenA, tokenB, stable, liquidity |
stake_lp | Stake LP tokens in a gauge | pool, amount |
unstake_lp | Unstake LP tokens from a gauge | pool, amount |
Locking & Voting
| Tool | Description | Parameters |
|---|
lock | Lock HDROME to create or extend a veNFT | amount, duration |
vote | Allocate veHDROME votes across gauges | tokenId, pools[], weights[] |
reset_votes | Reset votes for a veNFT | tokenId |
Rewards
| Tool | Description | Parameters |
|---|
claim_rewards | Claim all pending rewards | tokenId? |
claim_fees | Claim trading fees for a specific gauge | gauge |
claim_bribes | Claim external bribes | gauge, tokens[] |
Read-Only
| Tool | Description | Parameters |
|---|
get_pools | List all pools with TVL, APR, volume | sortBy?, limit? |
get_portfolio | Full wallet analysis | address |
get_yields | Top yield opportunities | limit?, minTvl? |
get_venft | Get veNFT details | tokenId |
get_pending_rewards | Check unclaimed rewards | address |
每个工具遵循 MCP 规范,使用 JSON Schema 定义输入:
{
"name": "swap",
"description": "Swap tokens on Hyperdrome (HyperEVM). Finds the optimal route across volatile and stable pools. Returns unsigned transaction for user approval.",
"inputSchema": {
"type": "object",
"properties": {
"fromToken": {
"type": "string",
"description": "Token symbol or address to sell (e.g. 'USDC' or '0xb883...')"
},
"toToken": {
"type": "string",
"description": "Token symbol or address to buy (e.g. 'HYPE')"
},
"amount": {
"type": "string",
"description": "Amount to swap in human-readable units (e.g. '100')"
},
"slippageBps": {
"type": "number",
"description": "Max slippage in basis points (default: 50 = 0.5%)"
}
},
"required": ["fromToken", "toToken", "amount"]
}
}
Claude Desktop / Cursor / Opencode
添加到您的 MCP 配置中:
{
"mcpServers": {
"hyperdrome": {
"url": "https://mcp.hyperdrome.finance/sse"
}
}
}
自托管
MCP 服务器将开源。运行您自己的实例:
git clone https://github.com/hyperdrome/mcp-server
cd mcp-server
npm install
PRIVATE_KEY=0x... RPC_URL=https://rpc.hyperliquid.xyz/evm npm start
安全模型
| 属性 | 详情 |
|---|
| 默认只读 | 投资组合查询和池数据无需钱包连接 |
| 交易审批 | 所有写操作返回未签名交易供用户审查和签名 |
| 无私钥 | 托管的 MCP 服务器从不接触私钥。签名在客户端完成。 |
| 速率限制 | 按 IP 和 API key 的速率限制以防止滥用 |
| 审计跟踪 | 每次工具调用都记录时间戳、参数和结果 |
MCP 服务器从不代表您执行交易。它构建交易并返回供您明确批准 — 就像任何 DeFi 前端一样。
使用场景
| 场景 | 方式 |
|---|
| 构建 DeFi 仪表盘的开发者 | 通过 MCP 工具查询池、收益和仓位 |
| AI 编程助手 | ”帮我写一个脚本来领取我所有的 Hyperdrome 奖励” — 助手调用 get_pending_rewards 然后 claim_rewards |
| 自主代理 | 投资组合管理代理每小时检查收益并通过 add_liquidity / remove_liquidity 进行再平衡 |
| 聊天机器人 | Telegram 机器人,让用户通过自然语言进行兑换、查看投资组合和投票 |
| 研究 | 分析师查询 get_pools 以构建跨 HyperEVM DEX 的收益对比 |