# AI use cases for Maid Kit (Solsynth/MaidKit) Repo: [Solsynth/MaidKit](https://github.com/Solsynth/MaidKit) | Use cases: 4 | Page: https://dedupedai.com/use-cases/solsynth-maidkit/ MaidKit is a cross-platform Flutter app for managing servers over SSH, with an optional outbound-only MaidCafe daemon for fleet monitoring and alarms. This file holds every use case of this repo. Each one starts with a "## " heading and ends with its URL. - Run Maid Kit locally to manage servers over SSH: https://dedupedai.com/use-cases/solsynth-maidkit/manage-servers-over-ssh-from-desktop/ - Build a Linux AppImage of Maid Kit for a workstation: https://dedupedai.com/use-cases/solsynth-maidkit/build-linux-appimage-for-admin-workstation/ - Monitor a server fleet with the MaidCafe daemon: https://dedupedai.com/use-cases/solsynth-maidkit/monitor-server-fleet-with-maidcafe-daemon/ - Let an AI agent read your servers through local MCP: https://dedupedai.com/use-cases/solsynth-maidkit/let-ai-agent-query-servers-through-local-mcp/ ## How to run Maid Kit locally to manage servers over SSH with Maid Kit Repo: [Solsynth/MaidKit](https://github.com/Solsynth/MaidKit) | Difficulty: Intermediate | Time: 45 minutes | Basis: From the README Build and launch the desktop app to view server status, open terminals, and edit files over SSH. **Who it is for:** A solo developer who runs a few Linux servers and wants one calm desktop tool for daily maintenance without installing agents on each host. **The problem:** Checking load, services, firewall rules, and files on several servers means juggling separate SSH sessions and tools. **The outcome:** A running Maid Kit window showing your servers on the Dashboard, with live terminal, file, service, and firewall views reached over SSH. ### Steps 1. Install the Flutter SDK (SDK ^3.12.2) from flutter.dev. 2. `flutter pub get` 3. `flutter run` 4. Add a server on the Dashboard with its SSH address and login, then open it. 5. Open the Terminal, Services, or Firewall tab to confirm the server responds. ### Prompt to paste into your agent ```text In the Solsynth/MaidKit repo, run `flutter pub get` and `flutter run` to start the desktop app, then add the server at with the SSH login . Expected output: the server card appears on the Dashboard with live status and load. Verify that the Terminal tab opens a shell on . ``` ### Caveat Day-to-day management is SSH-based, but a few tabs such as Packages and Databases act on the server through the commands they run, so check changes before applying them. Risk, credentials: SSH logins and private keys are stored in the Maid Kit vault, so protect the vault password and the device it runs on. Disclaimer: Third-party repos we don't own or vouch for. AI-generated use cases can be wrong: review everything and run at your own risk. Full text: https://dedupedai.com/disclaimer/ URL: https://dedupedai.com/use-cases/solsynth-maidkit/manage-servers-over-ssh-from-desktop/ ## How to build a Linux AppImage of Maid Kit for a workstation with Maid Kit Repo: [Solsynth/MaidKit](https://github.com/Solsynth/MaidKit) | Difficulty: Advanced | Time: 1 hour | Basis: From the README Compile the Linux release bundle and pack it into a single portable MaidKit-x86_64.AppImage file. **Who it is for:** A Linux admin who wants to copy one portable file to other workstations instead of building Flutter on each machine. **The problem:** Running the app on several Linux machines means repeating the Flutter build and dependency setup each time. **The outcome:** A file named MaidKit-x86_64.AppImage that runs Maid Kit on another x64 Linux machine. ### Steps 1. Install the Linux dependencies from the README: `sudo apt-get update -y`, then `sudo apt-get install -y ninja-build libgtk-3-dev libayatana-appindicator3-dev keybinder-3.0 libnotify-dev`. (inferred, check the README) 2. `flutter pub get` 3. `flutter build linux` 4. `bash buildtools/build-appimage.sh` 5. Copy MaidKit-x86_64.AppImage to a second x64 Linux machine and launch it. ### Prompt to paste into your agent ```text In the Solsynth/MaidKit repo, run `flutter build linux` and then `bash buildtools/build-appimage.sh`. Expected output: a file named MaidKit-x86_64.AppImage in the repo directory. Verify that the file exists and is non-empty before copying it to . ``` ### Caveat The README describes the AppImage script as packing the x64 release bundle, so builds for other CPU types are not covered by these steps. Disclaimer: Third-party repos we don't own or vouch for. AI-generated use cases can be wrong: review everything and run at your own risk. Full text: https://dedupedai.com/disclaimer/ URL: https://dedupedai.com/use-cases/solsynth-maidkit/build-linux-appimage-for-admin-workstation/ ## How to monitor a server fleet with the MaidCafe daemon with Maid Kit Repo: [Solsynth/MaidKit](https://github.com/Solsynth/MaidKit) | Difficulty: Intermediate | Time: 30 minutes | Basis: From the README Sign in to MaidCafe Cloud and let Maid Kit install an outbound-only daemon that streams live host metrics. **Who it is for:** A small team or indie operator with several VPS hosts who wants live load, memory, and disk views without opening inbound ports. **The problem:** Watching many hosts over SSH only shows what you check by hand, and alarms need something running on each host. **The outcome:** A Fleet view listing each daemon with live load, swap, disk, and network metrics, plus alarm notifications. ### Steps 1. Open Maid Kit and sign in with a Solarpass account. 2. Select a workspace. 3. Start the one-flow daemon setup for a server; Maid Kit probes it over SSH, installs the MaidCafe daemon, and registers it. 4. Open the Fleet view and check that the daemon's load, swap, disk, and network metrics update. 5. Set alarm thresholds so the daemon sends notifications when a limit is crossed. ### Prompt to paste into your agent ```text Using the Solsynth/MaidKit app, sign in with a Solarpass account, select a workspace, and run the one-flow daemon setup for . Expected output: the daemon appears in the Fleet view with live metrics. Verify that the daemon still reports after MaidKit is closed, since it runs on its own. ``` ### Caveat The README says the daemon only connects outbound and needs no open inbound ports, but it does not list every host requirement, so check the daemon's status after setup. Risk, credentials: Setup logs into the server over SSH, so use an account with the access the daemon install needs and review what it installs. Disclaimer: Third-party repos we don't own or vouch for. AI-generated use cases can be wrong: review everything and run at your own risk. Full text: https://dedupedai.com/disclaimer/ URL: https://dedupedai.com/use-cases/solsynth-maidkit/monitor-server-fleet-with-maidcafe-daemon/ ## How to let an AI agent read your servers through local MCP with Maid Kit Repo: [Solsynth/MaidKit](https://github.com/Solsynth/MaidKit) | Difficulty: Advanced | Time: 45 minutes | Basis: From the README Expose Maid Kit's servers, snippets, and skills to an MCP client on the same machine, with approval for actions. **Who it is for:** A developer who already uses an AI assistant and wants it to inspect servers on this machine without copying credentials into the chat. **The problem:** Asking an assistant about server state means pasting logs and commands by hand, which is slow and risks exposing secrets. **The outcome:** An MCP client that can list your Maid Kit servers and snippets, and propose server actions that wait for your approval. ### Steps 1. Run the app with `flutter run` from the repo folder. 2. Enable the Local MCP Server in Maid Kit settings. (inferred, check the README) 3. Add Maid Kit to your MCP client's configuration using the address and transport the app displays. (inferred, check the README) 4. Ask the agent to list the servers you have added. 5. Review each proposed action in review mode before approving it. ### Prompt to paste into your agent ```text With the Solsynth/MaidKit app running from `flutter run`, connect an MCP client to its local MCP Server and ask it to list the servers in MaidKit. Expected output: a list of server names matching those on the Dashboard. Verify that a proposed action from the agent waits for approval before it runs on . ``` ### Caveat The README says the local server exposes servers, snippets, and skills to clients such as Claude Desktop, but it does not document the connection settings, so the setup steps marked inferred must be checked in the app. Risk, remote script: Snippets and agent actions run commands on connected servers, so approve only the actions you have read. Disclaimer: Third-party repos we don't own or vouch for. AI-generated use cases can be wrong: review everything and run at your own risk. Full text: https://dedupedai.com/disclaimer/ URL: https://dedupedai.com/use-cases/solsynth-maidkit/let-ai-agent-query-servers-through-local-mcp/