What's Changed

• chore(deps): bump actions/checkout from 4 to 6 by @dependabot[bot] in #47
• chore(deps): bump actions/setup-python from 5 to 6 by @dependabot[bot] in #48
• chore(deps): bump github/codeql-action from 3 to 4 by @dependabot[bot] in #46
• chore(deps): bump docker/scout-action from 1.15.1 to 1.18.2 by @dependabot[bot] in #49
• chore(deps): bump rojopolis/spellcheck-github-actions from 0.36.0 to 0.56.0 by @dependabot[bot] in #50
• feat: Migrate to FastMCP framework v3.0.0 with tool annotations by @bjeans in #52
• docs: v3.0.0 comprehensive documentation cleanup and FastMCP alignment by @bjeans in #55

New Contributors

• @dependabot[bot] made their first contribution in #47

AI Assistance

• @claude
• Copilot (https://github.com/apps/copilot-pull-request-reviewer & https://github.com/apps/copilot-swe-agent)

Full Changelog: v2.2.1...v3.0.0

Security Update

This release addresses 9 dependency vulnerabilities by updating aiohttp from 3.13.2 to 3.13.3.

CVEs Addressed

Changes

• Security: Pinned aiohttp>=3.13.3 in requirements.txt to enforce fix
• Added: Dependabot configuration for automated daily Python dependency checks
• Reduced total vulnerabilities from 11 to 2 (remaining are unfixed upstream Alpine base image issues)

Remaining (unfixed upstream)

• zlib CVE-2026-22184 (CRITICAL) - no Alpine fix available yet
• busybox CVE-2025-60876 (MEDIUM) - no Alpine fix available yet

Full Changelog: v2.0.0...v2.2.1

🎉 Homelab MCP v2.0.0 - Production Release

Overview

Homelab MCP v2.0.0 introduces a major architectural update with containerized deployment and a unified MCP server. This release brings production-ready Docker support with automatic mode detection and marketplace compatibility.

✨ Key Features

🐳 Containerized Deployment

• Full Docker support with Dockerfile, docker-compose.yml, and .dockerignore
• Non-root user security (mcpuser UID 1000)
• Built-in health checks for production deployments
• Marketplace-ready configuration via environment variables
• System dependencies included (iputils-ping for cross-platform support)

🔗 Unified MCP Server

• Single homelab_unified_mcp.py runs all servers in one process
• Namespaced tools for unified mode (e.g., docker_get_containers, ping_ping_host)
• Automatic mode detection (unified vs. legacy)
• Cleaner logs with no duplicate warnings
• Better resource efficiency

🏗️ Infrastructure Coverage

• 7 MCP Servers: Ansible, Docker, Ping, Ollama, Pi-hole, Unifi, UPS
• 24+ Hosts monitoring capability
• Cross-platform: Windows, macOS, Linux support verified
• Dual-mode architecture: All servers support standalone and unified operation

⚙️ Configuration Options

• Ansible Inventory (Recommended): Centralized configuration with complex host groupings
• Environment Variables: Simple setup for basic deployments, marketplace-ready

🔒 Security & Production Features

• Docker non-root user execution
• Health checks configured for container orchestration
• Configuration loading via environment variables or Ansible inventory
• Comprehensive security documentation updated

📦 Available Servers

Unified Mode (Default - All Included)

• ansible_* - Ansible inventory queries
• docker_* - Docker/Podman container monitoring
• ping_* - Network ping utilities
• ollama_* - Ollama AI model management
• pihole_* - Pi-hole DNS monitoring
• unifi_* - Unifi network device monitoring
• ups_* - UPS/NUT power monitoring

Legacy Mode (Individual Servers)

Set ENABLED_SERVERS environment variable for backward compatibility

Note: MCP Registry Inspector is NOT included in Docker image - development tool only, run directly on host

🚀 Quick Start

Docker Deployment (Recommended)

git clone https://github.com/bjeans/homelab-mcp
cd homelab-mcp

# Build the image
docker build -t homelab-mcp:latest .

# Run with Docker Compose
docker-compose up -d

Direct Installation

pip install -r requirements.txt

# Run unified server
python homelab_unified_mcp.py

# Or run individual server (legacy)
python docker_mcp_podman.py

📚 Documentation

• README.md - Installation and setup guide
• DOCKER.md - Docker deployment guide
• SECURITY.md - Security policies and best practices
• CONTRIBUTING.md - Contribution guidelines
• CHANGELOG.md - Version history

🔄 Migration from v1.x

If you're upgrading from v1.x, see MIGRATION.md for guidance on:

• Tool name changes in unified mode
• Configuration migration
• Legacy mode compatibility

🐛 What's Fixed

• Docker MCP initialization in unified mode
• Configuration loading in unified server
• Inconsistent logging across MCP servers
• Empty inventory handling in ping server

📈 Infrastructure Tested

• 7 MCP servers fully integrated
• Tested with 24+ hosts across multiple services
• Docker Engine 20.10+ and Docker Compose 2.0+
• Windows, macOS, and Linux environments verified

🛣️ Roadmap

• Grafana dashboard integration
• Home Assistant integration
• Kubernetes deployment support
• Enhanced monitoring and alerting features

💡 Community

• Issues: Report bugs or request features
• Discussions: Join our community
• Security: Report security issues responsibly

📄 License

MIT License - See LICENSE for details

Thank you for using Homelab MCP! This release represents a major milestone in bringing production-grade infrastructure automation to Claude Desktop. 🚀

Homelab MCP v1.0.0 - Initial Release

First production release of Homelab MCP - Model Context Protocol servers for managing homelab infrastructure.

Features

• 🔧 7 MCP Servers: Docker/Podman, Ollama, Pi-hole, Unifi, Ansible, n8n, MCP Registry Inspector
• 🔒 Security-First: Pre-push checks, API key management, firewall guidance
• 📚 Comprehensive Docs: README, SECURITY.md, CONTRIBUTING.md, example configurations
• 🏗️ Dual Config: Support for both Ansible inventory and environment variables

Installation

See README.md for installation instructions.

Security

⚠️ Review SECURITY.md before deployment.