AI代理交易服务器

超液态mcp

用于交易的MCP服务器 超液体 通过AI代理。

使用自然语言与Claude、Cursor或任何兼容MCP的客户端交易永久期货和现货资产。

此MCP服务器正在积极开发中，如有更改，恕不另行通知。始终使用专用 代理人钱包 --从来不是你的主要钱包。对于您的AI代理可能采取的行动，我们无法保证。

快速开始

1.安装

需要 锈 1.85+.如果你没有：

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

然后安装MCP服务器：

cargo install hyperliquid -- hyperliquid-mcp

2.配置您的钱包 --创建 ~/.config/hyperliquid-mcp/.env 和你一起 主钱包 私钥：

# ~/.config/hyperliquid-mcp/.env
HYPERLIQUID_PRIVATE_KEY=0xyour_main_wallet_key
HYPERLIQUID_NETWORK=mainnet

首次运行时，服务器将自动：

• 创建一个专用的命名代理钱包进行交易
• 批准建筑商费用（0.01%用于支持开发）
• 将代理密钥保存到您的 .env 文件
• 继续正常运行

设置后，您的 .env 将包含这两个密钥。服务器使用 HYPERLIQUID_AGENT_PRIVATE_KEY 为了交易。

已经有代理钱包了吗？ 跳过自动设置——只需输入 HYPERLIQUID_AGENT_PRIVATE_KEY=0xyour_agent_key 在 .env 文件。看 私钥选项.

3.添加到您的MCP客户端

claude mcp add hyperliquid-mcp

{
  "mcpServers": {
    "hyperliquid": {
      "command": "hyperliquid-mcp"
    }
  }
}

{
  "mcpServers": {
    "hyperliquid": {
      "command": "hyperliquid-mcp"
    }
  }
}

您可能需要符号链接 hyperliquid-mcp 如果您的客户端无法连接到MCP。

$ sudo ln -s ~/.cargo/bin/hyperliquid-mcp /usr/local/bin/hyperliquid-mcp

4.开始交易 --问克劳德一些事情 “什么是顶级超液体市场？” 或 “以85000美元的价格购买0.01 BTC”.

建筑商费用 （0.01%）在设置过程中自动获得批准。如果手动设置，请参阅 建筑商费用 以获取批准说明。

工具

看 工具.

私钥选项

服务器按以下顺序检查您的私钥：

1. .env 文件（推荐）

服务器自动加载 ~/.config/hyperliquid-mcp/.env 在启动时。您的密钥保存在一个安全文件中，不在任何MCP客户端配置中。

# ~/.config/hyperliquid-mcp/.env
HYPERLIQUID_AGENT_PRIVATE_KEY=0xyour_agent_key
HYPERLIQUID_NETWORK=mainnet

2.内联环境变量

直接在MCP客户端配置中传递密钥。更简单，但密钥最终会出现在一个纯文本JSON文件中，该文件可能会被云备份同步或意外提交。

{
  "mcpServers": {
    "hyperliquid": {
      "command": "hyperliquid-mcp",
      "env": {
        "HYPERLIQUID_AGENT_PRIVATE_KEY": "0xyour_agent_key"
      }
    }
  }
}

3.壳体环境

在运行服务器之前导出shell中的变量，或使用 claude mcp add-env:

# Shell export
export HYPERLIQUID_AGENT_PRIVATE_KEY=0xyour_agent_key
hyperliquid-mcp

# Or via Claude Code
claude mcp add-env hyperliquid HYPERLIQUID_AGENT_PRIVATE_KEY 0xyour_agent_key

注： 显式环境变量始终优先于 .env 文件。如果 HYPERLIQUID_AGENT_PRIVATE_KEY 已在您的环境中设置 .env 值被忽略。

无密钥（只读模式）

如果没有提供私钥，服务器将以只读模式运行。所有市场数据工具都有效——您可以在不进行身份验证的情况下查看价格、订单簿和融资率。

配置

安全

优先使用代理钱包——不要使用你的主钱包密钥。

创建一个 app.hyperliquid.xyz/API。代理钱包是仅限交易的密钥，有严格的限制：

如果代理密钥被泄露，您的资金仍然安全——代理钱包无法将资金从您的账户中转移出去。

代理钱包过期

代理钱包的过期时间最多为 180天.当一个到期时：

• 它签署的所有操作都被拒绝——未结订单仍然存在，但不能放置或取消任何新订单
• 您必须创建一个新的代理钱包并更新配置
• 切勿重复使用过期的密钥 --每次生成一个新的

检查到期日期 app.hyperliquid.xyz/API。如果您怀疑密钥已泄露，请立即在那里撤销。

其他安全说明

• 使用 .env 文件 --保留您的私钥 ~/.config/hyperliquid-mcp/.env，不在MCP客户端配置中内联。看 私钥选项.
• 私钥仅从env读取，从不记录或通过网络发送。
• 只读模式无需任何按键即可工作。

看 docs/configuration.md 查看完整的安全指南。

文档

• 工具参考
• 配置和安全
• 建筑商费用

许可证

麻省理工学院