Hyperliquid MCP Server v5

A standalone Model Context Protocol (MCP) server for interacting with the Hyperliquid exchange API. This server provides tools for authentication, trading, and account management on the Hyperliquid exchange.

Features

• Authentication: Connect to Hyperliquid using a private key or wallet address
• Market Data: Fetch real-time market data for various assets
• Trading: Place and cancel orders on the Hyperliquid exchange
• Strategy Management: Create and manage trading strategies
• Account Information: View account balances, positions, and performance
• Dashboard: A user-friendly web interface for interacting with Hyperliquid

Quick Setup

Use this one-line command to set up the Hyperliquid MCP Server in your Next.js project:

git clone https://github.com/TradingBalthazar/hyperliquid-mcp-server-v5.git && cd hyperliquid-mcp-server-v5 && ./setup.sh && cd ..

This will:

1. Clone the repository
2. Install dependencies
3. Build the MCP server
4. Set up the dashboard in your Next.js project
5. Configure the MCP server to work with your project

Manual Setup

If you prefer to set up the server manually, follow these steps:

1. Clone the repository:

   git clone https://github.com/TradingBalthazar/hyperliquid-mcp-server-v5.git
   

2. Navigate to the repository directory:

   cd hyperliquid-mcp-server-v5
   

3. Install dependencies:

   npm install
   

4. Build the MCP server:

   npm run build
   

5. Run the setup script to configure your Next.js project:

   ./setup.sh
   

Starting the MCP Server

After setup, you can start the MCP server with:

node build/index.js

Using the Dashboard

The dashboard is accessible at http://localhost:3000 after starting your Next.js development server.

The dashboard allows you to:

• Connect to Hyperliquid using your credentials
• View your account information
• Monitor your perpetuals and spot positions
• Track your account value and performance

Available MCP Tools

The MCP server provides the following tools:

• authenticate: Connect to Hyperliquid using a private key or wallet address
• get_market_data: Fetch current market data for a specific asset
• place_order: Place an order on Hyperliquid
• cancel_order: Cancel an existing order
• create_strategy: Create a new trading strategy
• activate_strategy: Activate or deactivate a strategy

Available MCP Resources

The MCP server provides the following resources:

• hyperliquid://account: Current account information from Hyperliquid
• hyperliquid://strategy/{id}: Information about a specific trading strategy

Security Considerations

• This server stores credentials in memory for the duration of the session
• For production use, implement proper security measures for credential management
• Consider using a vault or secure key management system for private keys

License

MIT

Acknowledgements

• Hyperliquid for their exchange and API
• Model Context Protocol for the MCP framework