Hyperbolic 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.
Prerequisites and Installation:
Follow the ReadMe in the Git Repo https://github.com/HyperbolicLabs/hyperbolic-mcp
Usage
Running the server locally
To run the server:
npm start
Connecting with Claude for Desktop
- 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"
}
}
}
}
-
Restart Claude for Desktop.
-
Start a new conversation and interact with the server.
Note: You can provide environment variables either through the Claude Desktop config as shown above, or by creating a .env
file in the project root. The .env
file is only needed if you're not providing the variables through the config.
Available Tools
The server provides the following tools:
GPU Management Tools
list-available-gpus
Lists all available GPUs on the Hyperbolic network.
Example query: "Show me all available GPUs on Hyperbolic."
rent-gpu-instance
Rents a GPU instance from a specific cluster.
Parameters:
cluster_name
: The name of the cluster to rent (e.g., "extrasmall-chamomile-duck")node_name
: The name of the node (e.g., "prd-acl-msi-02.fen.intra")gpu_count
: Number of GPUs to rent
Example query: "I want to rent 4 GPUs from the extrasmall-chamomile-duck cluster."
terminate-gpu-instance
Terminates a GPU instance that you have rented.
Parameters:
instance_id
: The ID of the instance to terminate
Example query: "Terminate my GPU instance with ID abc123."
list-user-instances
Lists all active GPU instances that you have rented.
Example query: "Show me all my active GPU instances."
get-cluster-details
Gets detailed information about a specific cluster.
Parameters:
cluster_name
: The name of the cluster to get details for
Example query: "Tell me more about the cluster called extrasmall-chamomile-duck."
SSH Tools
ssh-connect
Establishes an SSH connection to a remote server.
Parameters:
host
: Hostname or IP address of the remote serverusername
: SSH username for authenticationpassword
: (Optional) SSH password for authenticationprivate_key_path
: (Optional) Path to private key fileport
: (Optional) SSH port number (default: 22)
Example query: "Connect to my GPU instance at 192.168.1.100 as user admin."
remote-shell
Executes a command on the connected remote server.
Parameters:
command
: Command to execute on the remote server
Example query: "Run 'nvidia-smi' on the connected server."
ssh-status
Checks the current SSH connection status.
Example query: "What's the status of my SSH connection?"
ssh-disconnect
Closes the active SSH connection.
Example query: "Disconnect from the SSH server."
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:
- Check that your API token is correct and not expired
- Ensure you have sufficient credits on your Hyperbolic account
- Check the server logs for error messages
- Verify your network connection to the Hyperbolic API
- If using SSH, verify that your private key path is correct and the key has the right permissions.
Updated 1 day ago