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コーディング・チャットツールでサポートされています。
なぜDeFiにMCPか？
現在、DeFiとのインタラクションには以下が必要です：
- ブラウザを開く
- ウォレットを接続
- 複雑なUIをナビゲート
- スリッページ、ルーティング、ガスを理解
HyperdromeのMCPサーバーを使用すれば、あらゆるAIアシスタントが直接トークンをスワップし、利回りを確認し、ゲージに投票し、ポジションを管理できます — ユーザーが好みのツールを離れることなく。
「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 |
ツールスキーマの例
各ツールは入力用のJSON Schemaと共にMCP仕様に従います：
{
"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サーバーは秘密鍵に触れない。署名はクライアント側で実行 |
| Rate Limiting | 不正利用防止のためのIP別およびAPIキー別のレート制限 |
| Audit Trail | すべてのツール呼び出しはタイムスタンプ、パラメータ、結果と共に記録 |
MCPサーバーはユーザーに代わってトランザクションを実行することはありません。トランザクションを構築し、明示的な承認のために返却します — 他のDeFiフロントエンドと同様です。
ユースケース
| シナリオ | 方法 |
|---|
| DeFiダッシュボードを構築する開発者 | MCPツールでプール、利回り、ポジションをクエリ |
| AIコーディングアシスタント | 「Hyperdromeの全報酬を請求するスクリプトを書いて」 — アシスタントがget_pending_rewardsの後にclaim_rewardsを呼び出し |
| 自律エージェント | ポートフォリオ管理エージェントが毎時利回りを確認し、add_liquidity / remove_liquidityでリバランス |
| チャットボット | Telegramボットでユーザーが自然言語でスワップ、ポートフォリオ確認、投票が可能 |
| リサーチ | アナリストがget_poolsをクエリしてHyperEVM DEX間の利回り比較を構築 |
