mirafleet
OfficialOptional integration with a GitLab instance for credential token self-rotation: central makes one outbound HTTPS connection to your GitLab to rotate tokens for a stored credential, keeping secrets on central so they never reach the agent.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
mirafleet
Let an AI coding agent drive fleets of servers through one central server,the way a CI server drives GitLab runners.
Quickstart · Install · Developer guide · Threat model · Discussions · Help test it
Status: v0.6.0, the first release (milestones M1 to M7 are built). Pre-1.0: the protocol and CLI can still change between minor versions. Read the threat model before you point it at anything important.
Why mirafleet
Your spare servers do the work. Point an agent at idle VMs and servers instead of handing it your laptop or your credentials.
Safe by construction. Runners dial out to central and nothing listens on them. In actions mode a runner runs only the argv-only, regex-checked actions in its own
actions.yaml. Every request is audited.Secrets stay put. In host mode, credentials live on central and never reach the agent.
Any harness, no lock-in. One static binary and a plain MCP server. No telemetry, and Apache-2.0.
Related MCP server: claude-mcp-bridge
How it works
Operators (your laptop, running mirafleet mcp) and runners both dial out to central over
SSH. The agent talks MCP to the orchestrator on your laptop; central routes each request to the
right runner and records it. Read the full story in the developer guide.
Works with
Harness | Setup guide |
Claude Code (plugin, with hooks) | |
opencode | |
Codex CLI | |
Gemini CLI | |
Cursor | |
VS Code (Copilot) | |
Cline | |
Kilo Code | |
Any stdio MCP client |
The core needs no hooks. What each harness adds is in integrations/.
Quickstart
Install the binary on each machine: see the install table.
Start central on a Linux VM, create a fleet, join a runner: QUICKSTART, part 1 to 3. No Linux VM handy? Try everything on one machine with Docker: part 7.
Connect your agent from your laptop: QUICKSTART, part 5.
Get involved
Test it: docs/TESTING.md is a 30 to 45 minute guide, with a report form.
Ask or share ideas: Discussions and SUPPORT.md.
Contribute: CONTRIBUTING.md and the Code of Conduct.
Report a vulnerability: privately, see SECURITY.md.
Read more: Design · Plan · Developer guide · wiki
What it is
Central is one Linux server. Runners dial out to it; the agent talks to it.
Runners run on the servers you want to manage. In actions mode a runner executes only the named, argv-only, regex-checked actions in its own
actions.yaml. In workspace mode the agent gets a private container. In host mode it works as an ordinary user on a dedicated VM, with credentials that stay on central and never reach the agent.The orchestrator (
mirafleet mcp) is an MCP server on your laptop (macOS, Linux or Windows). Every request is audited;confirmguards protect production fleets.An Admin GUI (HTTPS, served by central) manages fleets, runners, tokens, operators, credentials and the audit log.
No telemetry
mirafleet has no telemetry: no usage data, crash reports or update checks are sent anywhere. Its only network connections are the ones you configure. Central makes one optional outbound connection, HTTPS to your GitLab, only if you turn on GitLab token self-rotation for a credential.
Install
One binary, mirafleet, runs as central, runner or mcp. Central and runners are Linux only;
the orchestrator side also runs on macOS and Windows (amd64 and arm64). Pick one channel per
machine. Versions below are 0.6.0; replace them with the release you want.
Pre-releases (-rc.N) are not published to Homebrew or the MCP Registry, and go to npm dist-tag next.
Where | Channel | Command |
Central or runner (Linux) | Package (deb, rpm, apk) from the release page |
|
Central or actions runner (Linux) | Docker Compose ( |
|
Central or actions runner (Linux) | OCI image |
|
macOS, Linux | Homebrew |
|
macOS, Linux | Script |
|
Windows | Script (PowerShell 5.1 or 7, no admin) |
|
Any OS with Node 18+ | npm / npx ( |
|
Claude Code | Marketplace plugin (Node.js 18+ and the binary must be on |
|
Anywhere | Archive |
|
Go developers |
|
|
Notes:
Verify what you download. Every release has
checksums.txtwith a keyless cosign signature and GitHub build provenance.install.shandinstall.ps1always check the SHA-256;install.sh --verify-signaturealso requires the cosign signature. For other downloads runsha256sum -c checksums.txtand, if you use GitHub's tooling,gh attestation verify FILE --repo mirastacklabs-ai/mirafleet.Packages install
/usr/bin/mirafleet, systemd units (deb and rpm),/etc/mirafleet/*.envand the docs in/usr/share/doc/mirafleet/. They create themirafleetsystem user, never enable a service on their own, never delete data on removal, and do not change your firewall. apk (Alpine) ships the binary and config but no service files.No Apple or Microsoft code signing. Homebrew, npm,
install.shandinstall.ps1are not affected by quarantine. An archive downloaded in a browser is: after checking its checksum runxattr -d com.apple.quarantine mirafleet(macOS) orUnblock-File .\mirafleet.exe(Windows).The Claude Code plugin needs Node.js 18+ and
mirafleetonPATH; on Windows that must be a realmirafleet.exe(useinstall.ps1or the zip). The npm launcher is for plain MCP configs.Other harnesses (Codex CLI, Gemini CLI, Cursor, VS Code Copilot, Cline, Kilo Code, opencode, anything that speaks stdio MCP): see integrations/.
Quickstart in ten lines
Central and runner run on Linux; tokens and codes are read from stdin (-), never passed in
argv. The full quickstart covers firewalls, the GUI first-run setup,
runners, host mode and upgrades.
# On the central host (package installed)
sudo systemctl enable --now mirafleet-central # the journal shows the GUI fingerprint and setup-token path
sudo -u mirafleet mirafleet central fleet create dev -mode actions
sudo -u mirafleet mirafleet central token create -fleet dev # join token, shown once
# On a runner (after: sudo cp /usr/share/doc/mirafleet/examples/actions.yaml /etc/mirafleet/)
echo "$JOIN_TOKEN" | sudo -u mirafleet mirafleet runner join central.example.com:2222 -name web-1 -data /var/lib/mirafleet/runner -token -
sudo systemctl enable --now mirafleet-runner
# Back on central
sudo -u mirafleet mirafleet central runner approve dev/web-1
sudo -u mirafleet mirafleet central operator code # valid for 60 seconds
# On your laptop
echo "$REGISTRATION_CODE" | mirafleet mcp login central.example.com:2222 -name durga -code -
mirafleet mcp api fleets.list
mirafleet mcp api action.run '{"fleet":"dev","runner":"web-1","action":"uptime"}'Then open the Admin GUI at https://central.example.com:8443 (check the certificate
fingerprint against the central log first) and add the plugin or MCP config for your harness.
Safety in one paragraph
The runner re-checks every request against its own allowlist, so even a compromised central cannot make it run anything else. Workspaces and host mode give an agent room to work and still keep it away from your other machines and, in host mode, away from your secrets. Read what is not protected in docs/THREAT-MODEL.md: for example root on a runner VM, a compromised central, and (in host mode) a determined agent that reads its own runner's enrolment key.
License
Licensed under the Apache License, Version 2.0. Copyright 2026 mirastacklabs.
See NOTICE. Third-party licences are in THIRD_PARTY_LICENSES.txt in every archive,
package and image.
Disclaimer
mirafleet is software that runs commands on servers, and it can be driven by AI agents. Read this before you use it.
No warranty. mirafleet is provided "AS IS", without warranties or conditions of any kind, express or implied, as set out in Section 7 of the License.
No liability. In no event shall mirastacklabs, the authors or the contributors be liable for any damages arising from the use, misuse or inability to use mirafleet. This includes, without limitation, outages, data loss or corruption, security incidents, unauthorized access, and any action taken by a person or an AI agent through mirafleet, as set out in Section 8 of the License.
Misuse is the user's responsibility. Using mirafleet against systems you do not own or are not authorized to operate, or for any unlawful purpose, is prohibited. Any such use is solely the responsibility of the person or organization doing it.
You control what it can do. You are responsible for how you deploy and configure mirafleet: who can reach central, which operators and runners you approve, the actions you allow, the container images you use, and the permissions you grant to AI agents.
AI agents can make mistakes. An agent may misread instructions or be manipulated by content it reads, such as command output (prompt injection). Keep production fleets in
actionsmode, use theconfirmguards, and review what an agent is about to run.Your obligations stay yours. You are responsible for complying with applicable laws, your organization's policies, and the terms of any AI provider you use with mirafleet.
If you do not accept these terms, do not use mirafleet.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
MCP server for your apps' tools and custom tools, plus hosted AI agents and approval-gated workflows
Remote MCP server exposing your Node Command fleet (files, shell, processes, browser) to AI hosts.
Shared memory MCP server for Claude Code, Codex, Gemini CLI and Cursor. Cited, editable.
Hosted Web Crawler MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
Related MCP Servers
- AlicenseAqualityDmaintenanceMCP server that wraps Docker, Caddy, and GitHub Actions operations on a remote VPS, enabling Claude to take read-then-write-with-confirmation infrastructure actions over SSH with a service allowlist and audit-trail-friendly responses.8MIT
- AlicenseAqualityDmaintenanceMCP server that lets any agent or MCP host delegate tasks to Claude Code running headless, with tools for review, validation, analysis, and autonomous work.4974 npm2MIT
- FlicenseNot gradedqualityDmaintenanceA local MCP server that connects Claude Code to your work environment through auditable tools for file operations, API calls, and command execution, with safety gates and configuration.-
- AlicenseAqualityDmaintenanceA local MCP server that lets Claude Code orchestrate Codex CLI and OpenCode CLI as sub-agents with strict security, concurrency, and output limits.41MIT