Homelab MCP Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| PORT | No | The port the server will listen on | 3005 |
| API_KEY | Yes | Your API key for authentication (generate with: openssl rand -hex 32) | |
| TRUENAS_HOST | No | The hostname or IP address of your TrueNAS server (optional) | |
| OPNSENSE_HOST | No | The hostname or IP address of your OPNsense firewall (optional) | |
| TRUENAS_API_KEY | No | Your TrueNAS API key (optional) | |
| CAPABILITY_LEVEL | No | The capability level for the server (1-4). Level 1: Monitor (read-only), Level 2: Operate (start/stop), Level 3: Configure (read configs), Level 4: Manage (full control) | 1 |
| OPNSENSE_API_KEY | No | Your OPNsense API key (optional) | |
| OPNSENSE_API_SECRET | No | Your OPNsense API secret (optional) |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| docker_list_containersC | List all Docker containers with their status |
| docker_container_logsC | Get recent logs from a container |
| docker_container_statsC | Get CPU/memory/network stats for a container |
| system_infoB | Get host system information (disk, memory, CPU usage) |
| opnsense_statusB | Get OPNsense firewall/gateway status |
| truenas_statusB | Get TrueNAS pool health and system status |
| truenas_alertsB | Get active TrueNAS alerts |
| proxmox_statusB | Get Proxmox cluster status and node information |
| proxmox_list_vmsB | List all Proxmox VMs and containers across all nodes |
| proxmox_vm_statusC | Get detailed status of a specific Proxmox VM or container |
| home_assistant_statusB | Get Home Assistant version, entity count, and available domains |
| home_assistant_list_entitiesB | List all Home Assistant entities (lights, switches, sensors, etc.) |
| home_assistant_get_entityB | Get detailed state and attributes of a specific Home Assistant entity |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/bshandley/homelab-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server