MCP 服务器

MCP Server
Hyperdrome MCP 服务器在路线图中,尚未上线。本页记录了计划中的规格。

什么是 MCP?

Model Context Protocol (MCP) 是 Anthropic 推出的开放标准,允许 AI 助手发现并调用外部服务器上的工具。它使用 JSON-RPC 2.0 — 助手调用 tools/list 发现可用操作,然后调用 tools/call 执行它们。 MCP 已被 Claude DesktopCursorOpencodeWindsurf 以及越来越多的 AI 编程和聊天工具支持。

为什么将 MCP 用于 DeFi?

目前,与 DeFi 交互需要:
  1. 打开浏览器
  2. 连接钱包
  3. 在复杂的 UI 中导航
  4. 理解滑点、路由、Gas
通过 Hyperdrome 的 MCP 服务器,任何 AI 助手都可以直接兑换代币、查看收益、投票给 gauge、管理仓位 — 用户无需离开他们偏好的工具。
“在 Hyperdrome 上将 500 USDC 兑换为 HYPE” — 在 Claude Desktop、Cursor 或任何 MCP 客户端中输入即可。

可用工具

MCP 服务器将完整的 Hyperdrome 协议暴露为可调用工具:

Trading

ToolDescriptionParameters
swapSwap tokens with optimized multi-hop routingfromToken, toToken, amount, slippageBps?
get_quoteGet a swap quote without executingfromToken, toToken, amount

Liquidity

ToolDescriptionParameters
add_liquidityDeposit token pair into a pooltokenA, tokenB, amountA, amountB, stable
remove_liquidityWithdraw from a pooltokenA, tokenB, stable, liquidity
stake_lpStake LP tokens in a gaugepool, amount
unstake_lpUnstake LP tokens from a gaugepool, amount

Locking & Voting

ToolDescriptionParameters
lockLock HDROME to create or extend a veNFTamount, duration
voteAllocate veHDROME votes across gaugestokenId, pools[], weights[]
reset_votesReset votes for a veNFTtokenId

Rewards

ToolDescriptionParameters
claim_rewardsClaim all pending rewardstokenId?
claim_feesClaim trading fees for a specific gaugegauge
claim_bribesClaim external bribesgauge, tokens[]

Read-Only

ToolDescriptionParameters
get_poolsList all pools with TVL, APR, volumesortBy?, limit?
get_portfolioFull wallet analysisaddress
get_yieldsTop yield opportunitieslimit?, minTvl?
get_venftGet veNFT detailstokenId
get_pending_rewardsCheck unclaimed rewardsaddress

Tool Schema 示例

每个工具遵循 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 的收益对比