Hyperbolic GPU MCP Server

Interact with Hyperbolic's GPU cloud, enabling agents and LLMs to view and rent available GPUs, SSH into them, and run GPU-powered workloads for you.

Setup# Prerequisites

• Node.js 16 or higher
• npm or yarn
• A Hyperbolic API token
• (Optional) SSH private key for connecting to GPU instances

Getting a Hyperbolic Account and API Token

1. Register for a Hyperbolic account:

• Visit https://app.hyperbolic.xyz/
• Create an account or log in to your existing account
• Verify your email address

2. Deposit funds into your account:

• Log in to your Hyperbolic application
• Navigate to the "Billing" tab
• Select how much you want to deposit (we suggest starting with $25)
• Click Pay Now
• Follow the instructions to add funds to your account
• Note that you will need sufficient funds to rent GPU instances

3. Generate an API token:

• In your Hyperbolic dashboard, navigate to "Settings"
• Navigate to the API Key section
• Copy the generated token and keep it secure
• You will use this key in your MCP server configuration environment variables

4. Add your SSH public key:

• Generate an SSH key pair if you don't already have one
• In your Hyperbolic application, navigate to the "Settings" section
• Scroll down to the SSH Public Key section
• Paste your public key (usually from ~/.ssh/id_rsa.pub or similar)
• Click the save icon

Installation

1. Clone this repository:

   git clone https://github.com/HyperbolicLabs/hyperbolic-mcp
   cd hyperbolic-mcp
   

2. Install dependencies:

   npm install
   

3. Build the TypeScript files:

   npm run build
   

Usage# Running the server locally

To run the server:

npm start

Connecting with Claude for Desktop

1. Add the server to your Claude for Desktop config:

   {
     "mcpServers": {
       "hyperbolic-gpu": {
         "command": "node",
         "args": ["/path/to/hyperbolic-mcp-server/build/index.js"],
         "env": {
           "HYPERBOLIC_API_TOKEN": "your-hyperbolic-api-token",
           "SSH_PRIVATE_KEY_PATH": "/path/to/your/privatekey"
         }
       }
     }
   }
   

2. Restart Claude for Desktop.
3. Start a new conversation and interact with the server.

Available Tools

The server provides the following tools:

GPU Management Tools

• list-available-gpus: Lists all available GPUs on the Hyperbolic network.
• rent-gpu-instance: Rents a GPU instance from a specific cluster.
• terminate-gpu-instance: Terminates a GPU instance that you have rented.
• list-user-instances: Lists all active GPU instances that you have rented.
• get-cluster-details: Gets detailed information about a specific cluster.

SSH Tools

• ssh-connect: Establishes an SSH connection to a remote server.
• remote-shell: Executes a command on the connected remote server.
• ssh-status: Checks the current SSH connection status.
• ssh-disconnect: Closes the active SSH connection.

Security Notes

• This server requires your Hyperbolic API token and optionally an SSH private key.
• These credentials can be provided either through the Claude Desktop config or a .env file.
• The server only runs locally and doesn't expose your credentials externally.
• Commands to rent GPUs will incur charges on your Hyperbolic account.
• The SSH private key must not be password protected as the server cannot handle password-protected keys.

Troubleshooting

If you encounter issues:

1. Check that your API token is correct and not expired.
2. Ensure you have sufficient credits on your Hyperbolic account.
3. Check the server logs for error messages.
4. Verify your network connection to the Hyperbolic API.
5. If using SSH, verify that your private key path is correct and the key has the right permissions.