MCP超液体服务器
与去中心化的永久期货交易所Hyperliquit集成的模型上下文协议（MCP）服务器。该服务器将Hyperliquit的交易API作为MCP工具公开，允许像Claude这样的人工智能助手以编程方式与交易所交互。
特性
账户与职位管理
- 查询职位：查看所有当前未结头寸和实时损益
- 查询订单：访问未结订单和历史订单数据
- 账户信息：获取账户余额、保证金和杠杆详细信息
市场数据
- 实时价格：获取任何永久合约的当前市场价格
- 订单簿：查看买卖深度和价差
- 市场统计数据：访问24小时交易量、融资利率和未平仓合约
- 历史数据：查询蜡烛/OHLCV数据以进行技术分析
交易操作
- 创建订单：下达限价单、市价单和止损单
- 取消订单：取消单个或所有未结订单
- 修改订单：更新现有订单的价格和尺寸
- 职位管理：用市价单平仓
风险管理
- 杠杆控制：调整不同资产的杠杆率
- 位置监测：跟踪未实现损益和清算价格
- 订单验证：价格和尺寸参数的执行前检查
安装和设置
先决条件
- Node.js>=18
- Claude桌面应用程序
- 超液体钱包私钥
与Claude Desktop集成
将以下配置添加到您的 claude_desktop_config.json 文件：
地点：
- macOS：
~/Library/Application Support/Claude/claude_desktop_config.json - 窗户：
%APPDATA%/Claude/claude_desktop_config.json
配置：
{
"mcpServers": {
"hyperliquid": {
"command": "npx",
"args": ["-y", "@sondn.contact/mcp-hyperliquid"],
"env": {
"HYPERLIQUID_PRIVATE_KEY": "your_private_key_here",
"HYPERLIQUID_TESTNET": "false"
}
}
}
}配置参数：
HYPERLIQUID_PRIVATE_KEY：您的Hyperliquit钱包私钥（必填）HYPERLIQUID_TESTNET：设置为"true"对于测试网，"false"或省略主网
重新启动克劳德桌面 在更新配置文件之后。
用法示例
配置后，您可以使用自然语言通过Claude Desktop与Hyperliquit交互：
查询示例
- "Show all my current positions on Hyperliquid"
- "What are my open orders?"
- "What's the current price of BTC-PERP?"
- "Show me the order book for ETH-PERP"
- "What's my account balance and margin usage?"交易示例
- "Create a limit buy order for 0.1 BTC-PERP at $50,000"
- "Place a market sell order for 1 ETH-PERP"
- "Cancel all my open orders"
- "Close my SOL-PERP position"
- "Set leverage to 5x for BTC-PERP"分析举例
- "What's my total unrealized P&L?"
- "Show me the funding rate for all my positions"
- "What's the 24h volume for BTC-PERP?"
- "Get 1-hour candles for ETH-PERP from the last 24 hours"安全
⚠️ 重要安全注意事项：
- 永远不要将私钥提交给版本控制
- 私钥仅在Claude Desktop的配置文件中配置
- 始终使用测试网进行开发和测试 在用真实资金交易之前
- 执行前验证所有交易参数（价格、大小、交易品种）
- 注意市场订单的下滑
- 定期监控您的头寸和账户余额
发展
为了地方发展和贡献：
# Install dependencies
npm install
# Build the project
npm run build
# Run in development mode
npm run dev
# Run tests
npm test运作原理
此MCP服务器充当Claude（或任何MCP客户端）和Hyperliquit之间的桥梁：
- MCP协议：使用模型上下文协议通过stdio与Claude Desktop通信
- 超流API：与REST和WebSocket API集成
- 认证：对经过身份验证的请求使用Ed25519加密签名
- 环境支持：适用于Hyperliquit主网和测试网
技术栈：
- TypeScript用于类型安全开发
- 用于协议实现的MCP SDK
- 用于交易操作的Hyperliquid REST API
- 用于实时数据的Hyperliquid WebSocket API
- Ed25519身份验证签名
可用的MCP工具
服务器向Claude公开了以下工具：
get_positions-检索所有空缺职位get_orders-获取公开订单和历史订单get_account_info-获取账户余额和保证金详细信息get_market_data-查询实时市场数据create_order-下新订单cancel_order-取消特定订单cancel_all_orders-取消所有未结订单modify_order-更新现有订单close_position-用市价单平仓
故障排除
服务器未连接：
- 验证配置文件路径和JSON语法
- 检查是否安装了Node.js 18+：
node --version - 配置更改后重新启动Claude Desktop
身份验证错误：
- 确保您的私钥正确且格式正确
- 验证您使用的网络是否正确（主网与测试网）
交易错误：
- 检查您是否有足够的余额和保证金
- 验证符号格式（例如，“BTC-PERP”而非“BTCUSD”）
- 确保价格和尺寸符合兑换要求
资源
许可证
麻省理工学院
贡献
欢迎投稿！请随时提交问题或拉取请求。
联系
有关开发AI工具或自定义MCP服务器的咨询，请联系：
电子邮件： sondn.5442@gmail.com
无论您需要定制集成、新的MCP服务器开发还是人工智能工具咨询，都可以随时联系。
免责声明
本软件按“原样”提供，不提供保修。使用风险自负。交易加密货币具有重大的财务风险。始终先在测试网上进行测试，永远不要用你无法承受损失的资金进行交易。