خادم MCP
خادم MCP من Hyperdrome في خريطة الطريق وليس مباشراً بعد. تُوثّق هذه الصفحة المواصفات المُخطط لها.
ما هو MCP؟
Model Context Protocol (MCP) هو معيار مفتوح من Anthropic يتيح لمساعدي الذكاء الاصطناعي اكتشاف واستدعاء الأدوات على خوادم خارجية. يستخدم JSON-RPC 2.0 — يستدعي المساعد tools/list لاكتشاف الإجراءات المتاحة، ثم tools/call لتنفيذها.
يُدعم MCP من Claude Desktop وCursor وOpencode وWindsurf وعدد متزايد من أدوات البرمجة والمحادثة بالذكاء الاصطناعي.
لماذا MCP لـ DeFi؟
يتطلب التفاعل مع DeFi اليوم:
- فتح متصفح
- ربط محفظة
- التنقل في واجهة معقدة
- فهم الانزلاق السعري والتوجيه والغاز
مع خادم MCP من Hyperdrome، يمكن لأي مساعد ذكاء اصطناعي مباشرة تبديل الرموز والتحقق من العوائد والتصويت على المقاييس وإدارة المراكز — دون أن يغادر المستخدم أداته المفضلة.
“بدّل 500 USDC إلى HYPE على Hyperdrome” — مكتوبة في 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 المُستضاف لا يلمس المفاتيح الخاصة أبداً. التوقيع يتم من جانب العميل. |
| Rate Limiting | حدود معدل لكل IP ولكل مفتاح API لمنع إساءة الاستخدام |
| Audit Trail | كل استدعاء أداة يُسجّل مع الطابع الزمني والمعايير والنتيجة |
لا ينفّذ خادم MCP المعاملات نيابة عنك أبداً. يبني المعاملة ويُعيدها لموافقتك الصريحة — تماماً كأي واجهة DeFi أخرى.
حالات الاستخدام
| السيناريو | الطريقة |
|---|
| مطوّر يبني لوحة تحكم DeFi | استعلام المجمعات والعوائد والمراكز عبر أدوات MCP |
| مساعد برمجة بالذكاء الاصطناعي | ”ساعدني في كتابة سكريبت يطالب بجميع مكافآتي على Hyperdrome” — يستدعي المساعد get_pending_rewards ثم claim_rewards |
| وكيل مستقل | وكيل إدارة محفظة يفحص العوائد كل ساعة ويُعيد التوازن عبر add_liquidity / remove_liquidity |
| روبوت محادثة | روبوت Telegram يتيح للمستخدمين التبديل وفحص المحفظة والتصويت عبر اللغة الطبيعية |
| بحث | محلل يستعلم get_pools لبناء مقارنة عوائد عبر منصات HyperEVM |
