Hyper Liquid MCP

HyperLiquid FastMCP 服务器 🚀

这个存储库包含一个使用Python的FastMCP框架构建的模型上下文协议（MCP）服务器。该服务器提供了来自HyperLiquid去中心化交易所（DEX）Python SDK的功能（如获取价格或检查账户余额），以便AI代理或类似MCP Inspector的客户端使用。

⚙️ 设置与安装1. 先决条件

您的系统上必须安装 Python 3.10 或更高版本

克隆此仓库：

git clone https://github.com/Phoenix2066/HyperLiquidMCP
cd .\HyperLiquidMCP

创建并激活虚拟环境

创建Python虚拟环境：

python -m venv venv

要激活虚拟环境：\ Windows：

.\venv\bin\activate

Mac/Linux：

source myenv/bin/activate

安装依赖项

安装所需的Python包：

pip install fastmcp hyperliquid-python-sdk python-dotenv eth-account

🔐 配置（身份验证）

此服务器使用您钱包的私钥来对交易操作请求和查看私有账户数据的请求进行签名。

⚠️ 安全警告 不要使用包含真实资金的主要钱包的私钥。始终使用专门的测试网密钥或一个小的、独立的账户来进行自动化交易和测试。

步骤：

• 创建 .env 文件：在本项目的根目录下，创建一个名为 .env 的新文件。
• 导出密钥：从您的MetaMask（或其他EVM钱包）测试账户中导出64个字符的私钥。
• 添加配置：将密钥粘贴到.env文件中，并设置环境标志：

# Replace the placeholder with your 64-character private key
HYPERLIQUID_PRIVATE_KEY="YOUR_64_CHAR_PRIVATE_KEY_HERE"
# Set to 'true' to ensure connection to the Testnet environment
HYPERLIQUID_TESTNET="true"

🔬 运行和监控服务器

您可以使用fastMCP Inspector来运行和测试服务器：

1. 打开MCP检查器：

   npx @modelcontextprotocol/inspector

该命令将启动一个本地服务器，并在控制台打印一个URL（例如，http://127.0.0.1:6274）。

1. 在您的网页浏览器中打开该网址。\

在检查器用户界面中，STDIO 传输的连接详细信息应已预先填写。点击“连接”。然后转到“工具”选项卡。

1. 现在，您可以通过工具选项卡直接测试已暴露的函数。