​
MCP 서버

MCP Server
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와 상호작용하려면 다음이 필요합니다:
  1. 브라우저 열기
  2. 지갑 연결
  3. 복잡한 UI 탐색
  4. 슬리피지, 라우팅, 가스 이해
Hyperdrome의 MCP 서버를 사용하면 모든 AI 어시스턴트가 직접 토큰을 스왑하고, 수익률을 확인하고, 게이지에 투표하고, 포지션을 관리할 수 있습니다 — 사용자가 선호하는 도구를 벗어나지 않고도.
“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

​
도구 스키마 예시

각 도구는 입력에 대한 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 간 수익률 비교 구성