Ubuntu Fleet Manager
Provides administration-oriented tooling for Ubuntu hosts. Currently exposes a read-only get_system_info tool that reports the local host's OS release, hostname, kernel, architecture, memory, and root filesystem capacity.
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.
Ubuntu Fleet Manager
Ubuntu Fleet Manager is an early-stage, self-hosted MCP service for administering Ubuntu hosts. The Go runtime exposes local system information over MCP stdio and an authenticated Streamable HTTP control plane with a tenant-scoped host inventory, one-time host enrollment, outbound agent liveness polling, and typed host operations.
The repository retains the original Python server as a legacy implementation alongside the Go runtime and independent Python and Node MCP connector packages. The root Python package documentation describes the legacy server; use the Go instructions below to run the fleet manager.
Build and run
The Go command requires Linux and the Go version listed in go.mod. Build the MCP server with:
go build -o ./build/ubuntu-fleet-manager ./cmd/ubuntu-fleet-managerThe default stdio transport is for a local MCP client. Configure the client to launch the built binary directly. For Codex, add a server entry to ~/.codex/config.toml:
[mcp_servers.ubuntu_fleet_manager]
command = "/absolute/path/to/ubuntu-fleet-manager/build/ubuntu-fleet-manager"
args = []
startup_timeout_sec = 30
tool_timeout_sec = 30Restart Codex and use /mcp to check the connection. The server writes protocol messages to standard output; diagnostics go to standard error.
Related MCP server: linux-mcp-server
Self-hosted control plane
The Streamable HTTP service uses PostgreSQL and a provider-neutral OIDC issuer. It creates one private tenant for each (issuer, subject) identity and scopes list_hosts to that tenant. The service verifies access tokens; the identity provider performs interactive sign-in and issues tokens.
For a local deployment, copy .env.example to .env, set a long URL-safe POSTGRES_PASSWORD, and configure OIDC_ISSUER_URL and OIDC_AUDIENCE. Start the stack with:
docker compose up --build --detach
docker compose psThe service binds to 127.0.0.1:8080. Put a TLS reverse proxy in front of it for remote access and set PUBLIC_URL to the external HTTPS base URL before starting the stack. See Deploy the self-hosted control plane and Control plane configuration for the required settings, agent endpoints, and readiness endpoint.
The control plane also requires a private 32-byte application encryption key at secrets/file-action-key; see the deployment guide before running Compose. Reversible file tools stay disabled unless ALLOW_FILE_WRITES=true and each host has explicit writable_paths. APT tools stay disabled unless ALLOW_APT_WRITES=true and each host has agent and root-owned package policies plus the dedicated sudo helper rule. Generic command execution stays disabled unless ALLOW_COMMAND_EXECUTION=true and each host has an exact executable and argv policy.
Available tools
get_system_inforeads OS release, hostname, kernel, architecture, memory, and root filesystem capacity from the host running the Go MCP server. It accepts no arguments and returns typed structured content. See Get system information.get_host_system_inforequests a fresh snapshot from one enrolled host in the authenticated operator's personal tenant. It waits up to 90 seconds for the host agent. See Get system information from a managed host.list_directorylists at most 100 entries on an enrolled host inside the agent's configured read boundaries. See List a directory on a managed host.read_filereads at most 256 KiB of UTF-8 text from an enrolled host inside the agent's configured read boundaries. See Read a file on a managed host.search_packagessearches configured APT indexes on an enrolled host without changing package state. See Search APT packages on a managed host.apt_updaterefreshes indexes from existing configured APT repositories. See Refresh APT package indexes.apt_install,apt_remove, andapt_upgradeoperate on allowlisted package names with captured package state for bounded rollback. See Install APT packages, Remove APT packages, and Upgrade APT packages.rollback_apt_actionattempts to restore captured package versions and installation state for seven days. Dependency and repository changes can make the result partial. See Roll back an APT action.execute_commandruns only an exact host-allowlisted executable and argument vector, directly without a shell. It is disabled by default, has no rollback, and requires a client that requests per-call human confirmation. See Execute an allowlisted command.write_filewrites at most 256 KiB of UTF-8 text inside a separately configured host writable boundary and records encrypted reversal data for seven days. See Write a file on a managed host.rollback_filerestores the prior existence, contents, and mode captured bywrite_file, while preserving later manual edits. See Roll back a managed file write.list_hostsis available over authenticated Streamable HTTP. It returns paginated inventory for the caller's personal tenant. See List managed hosts.create_pairing_codecreates a one-time code that expires after ten minutes and belongs to the authenticated operator's personal tenant. The code is a secret and appears only in the tool result. See Create a host pairing code.remove_hostremoves a host from active inventory and immediately revokes its credential. See Remove a managed host.
get_system_info, get_host_system_info, list_hosts, list_directory, read_file, and search_packages are read-only. create_pairing_code creates enrollment state, remove_host revokes access, and the optional file and package tools perform typed operations under server-side and host policy. The optional command tool does not invoke a shell and runs only exact executable and argv pairs allowed by the host policy. The credential is returned only to the agent during successful enrollment and is not included in MCP results.
Run a host agent
Build or install the Go binary on the Ubuntu host, then enroll and run it as an unprivileged account. The enrollment guide shows how to pass the pairing code through standard input, store the credential with mode 0600, and configure a systemd service. See Enroll and run a host agent. To enable APT operations, follow Configure APT package policy. To enable constrained commands, follow Configure constrained command execution.
Python and Node clients
The independent packages in connectors/python and connectors/node use the official MCP client SDKs to launch the Go runtime over stdio or connect to its authenticated Streamable HTTP endpoint. They return the SDK's tool definitions, results, and errors without reimplementing host operations. See Connect Python and Node clients.
Development
Run the stdio contract tests and static checks with the pinned toolchain:
GOTOOLCHAIN=go1.27.3 go test ./...
GOTOOLCHAIN=go1.27.3 go vet ./...
GOTOOLCHAIN=go1.27.3 go build ./...The control-plane integration test uses a local PostgreSQL database. Set UFM_TEST_DATABASE_URL to a disposable test database URL to run it; without that variable, the Go test suite skips only the PostgreSQL integration test. CI runs it against PostgreSQL 18 and a local test OIDC issuer. The official Go MCP SDK is pinned in go.mod.
Project documentation
Documentation index organizes Tutorials, How-to, Reference, and Explanation pages.
GLOSSARY.mddefines the domain terms used in the project.SKILL.mddescribes safe local development, deployment, MCP connections, and test commands for coding agents.docs/adr/records accepted architecture decisions.Reference index links to tool schemas, limits, host-agent endpoints, and configuration.
AGENTS.mdanddocs/agents/describe repository and issue-tracker conventions.Ubuntu Server documentation is the source for Ubuntu administration guidance. Feature docs use its Tutorial, How-to, Reference, and Explanation conventions.
Project specification and implementation tickets track the v0.1.0 work.
This project is not affiliated with Canonical. Ubuntu is a registered trademark of Canonical Ltd.
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
Linux server administration over OAuth MCP: shell, Docker, systemd, files and monitoring.
Toolstile is a managed MCP gateway that connects remote MCP servers behind one endpoint, with per-agent permissions, shared accounts and activity logs. Connect at https://mcp.toolstile.com/mcp over Streamable HTTP with OAuth; sign in at https://toolstile.com, select a workspace and connect your upstream servers. Available tools, resources and prompts depend on that workspace and the agent's granted access.
SSH client, server management and one remote MCP URL for your machines, with human approvals.
MCP server for mandates, delegation, policy-gated execution, credential grants, and audit.
Related MCP Servers
- FlicenseAqualityDmaintenanceLightweight MCP server that exposes tools for system information and weather lookup, designed for agent integration via stdio.1-
- AlicenseBqualityDmaintenanceAn MCP server for managing Ubuntu/Linux systems, enabling AI assistants to execute commands, manage services, files, logs, and packages via local or SSH connection.47MIT
- AlicenseAqualityDmaintenanceProvides system hardware information (CPU, memory, storage, etc.) and system status (OS, network, resource usage) via MCP tools.210 npmISC
- FlicenseAqualityDmaintenanceA minimal MCP server that exposes a single tool to query local hardware information (OS, CPU, memory, architecture).1-