CloudLab MCP Server
An MCP (Model Context Protocol) server for managing CloudLab/Emulab experiments. This allows AI assistants like Claude to interact with your CloudLab experiments directly.
Features
- Create experiments - Create new experiments from profiles
- List experiments - View all your CloudLab experiments
- Get experiment details - See detailed status including node states
- Reboot nodes - Reboot individual nodes or all nodes in an experiment
- Reload/reimage nodes - Reload a node with its disk image
- Power cycle nodes - Hard reboot for unresponsive nodes
- Extend experiments - Request time extensions
- Terminate experiments - Clean up when done
Prerequisites
- Node.js 18+
- A CloudLab account with API access
- A valid CloudLab JWT token
Installation
npm install
npm run build
Configuration
Getting your CloudLab JWT Token
- Log in to CloudLab
- Go to your user profile
- Navigate to "Download Credentials" or generate an API token
- Save the token as
cloudlab.jwt
Token Location
The server looks for your JWT token in these locations (in order):
- Path specified in
CLOUDLAB_TOKEN_PATHenvironment variable cloudlab.jwtin the project directory~/Downloads/cloudlab.jwt
Important: Never commit your JWT token to version control!
Usage with Claude Desktop
Add to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"cloudlab": {
"command": "node",
"args": ["/path/to/cloudlab-mcp/dist/index.js"]
}
}
}
Available Tools
| Tool | Description |
|---|---|
create_experiment | Create a new experiment from a profile |
list_experiments | List all your experiments |
get_experiment | Get detailed status of an experiment |
reboot_node | Reboot a specific node |
reboot_all_nodes | Reboot all nodes in an experiment |
reload_node | Reload/reimage a node |
powercycle_node | Power cycle a node (hard reboot) |
extend_experiment | Extend experiment expiration |
terminate_experiment | Terminate an experiment |
Environment Variables
| Variable | Description |
|---|---|
CLOUDLAB_TOKEN_PATH | Custom path to your JWT token file |
CLOUDLAB_API_URL | Override the API endpoint (default: https://www.emulab.net:43794) |
License
MIT