fleet MCP server

<!-- mcp-name: io.github.lion-zhang/fleet -->

fleet — let your coding agent use every machine you have

Claude Code, Codex and Gemini see one machine: the one they run on. fleet shows them all of yours — every GPU, how much is free, and how to get there.

No account, no cloud service, nothing installed on the machines you add: just the SSH you already use.

The problem

Ask your agent to train a model and it starts on your laptop — while a 4090 sits idle across the room and a rented A100 bills you by the hour. It cannot use what it cannot see.

• Your agent is stuck on one machine. It has no idea your other boxes exist.
• Finding a free GPU is manual. SSH into five hosts, run nvidia-smi, compare in your head.
• Handing it a server means pasting credentials into the chat, and hoping.

Get started: ask your agent

Paste this into Claude Code, Codex, Gemini CLI, or any agent that can run commands, on the machine you work from:

Install fleet from https://github.com/lion-zhang/fleet

Agents: the steps are in INSTALL.md.

That machine becomes your fleet's center: it keeps the list of your machines and decides which may reach which. A desktop or home server that is usually on suits it best, but a laptop works too, and you can move the role later.

That is the whole setup. fleet is installed once on this machine, and every supported agent you have here learns it — not only the one you asked. From here on you say what you want in plain words, with no commands to remember.

Then add your machines

Tell the agent how you reach a machine — the SSH command you already use is enough:

You: add my GPU server, ssh ubuntu@10.0.0.7

Agent: Added as gpu-box: 2× RTX 4090, both idle, 46 GB free. It's ready to use.

Each one takes a sentence, whatever the machine is:

Nothing is installed on the machines you add: they only need SSH, on Linux, macOS or Windows. fleet probes each one for its GPUs, memory and disks, and keeps that current.

Then let the agent pick

You describe the work; the agent finds where it fits. It checks what each machine has and what is free on it right now, so it will not send a job to a busy card:

Shortened. The full README is on GitHub.