Manage a Linux VPS, Postgres and Odoo databases and GitLab deploys over SSH, with previews, allowlists and an audit trail.
Ask "is Odoo healthy?" and get one typed answer back instead of an agent scraping shell output. That is the core idea behind this project, published on PyPI as steward-mcp. The VPS MCP server runs on your laptop and reaches a Linux server over SSH, issuing only its own validated command templates. Nothing is installed permanently on the target host beyond a dedicated user, an SSH key and a narrow sudoers profile.
It is large. By default the server exposes a compact surface of 13 action-based tools; pass --mode full or set VPS_MCP_MODE=full to get the granular 45-tool catalogue instead. The compact set includes:
assess_infrastructure for a health verdict covering load, memory, disk and runtimesservice_inspect, service_control and service_manage for systemd units and Docker or Podman containers, including deploys and rollbacksdb_inspect, rehearsal_manage and migration_audit for PostgreSQL and Odoo schema comparison and upgrade rehearsals on throwaway copiesgitlab_repo, gitlab_items, gitlab_ci and gitlab_deploy for an allowlisted GitLabjob_manage and memory_manageCompanion servers ship in the same package: kb-mcp for semantic search over PDFs and books, and agent-memory for a shared fact store. A personal assistant layer adds Google Calendar, Gmail, Telegram and a web cockpit, which goes well beyond server administration.
Expect half an hour of careful setup. You need Python 3.12 or newer and uv locally, and a systemd Linux host (Ubuntu 22.04+, Debian 12+ or RHEL 9+ are suggested). Create a dedicated SSH key and user, generate and review the sudoers file, pin the host key with trust-host, then write a TOML policy file starting with read_only = true and run check-config. Only flip read-only off once you trust it. GitLab access uses your own token stored in the macOS Keychain.
confirm=true.Even so, container runtime and package manager access is effectively root, so the SSH key deserves real protection. The server deploys images from approved sources only and never builds code on the VPS. Browse our other integrations for adjacent tools, or the rest of that category for different approaches.
Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.
| Tool | What it does |
|---|---|
| assess_infrastructure | Overall VPS health verdict: load, memory, disk headroom, runtimes and warnings. |
| service_inspect | Lists services and reads status, logs, config, revisions and the audit log. |
| service_control | Starts, stops, restarts and toggles boot start for services. |
| service_manage | Deploys, updates, configures, rolls back or removes services, previewing first. |
| db_inspect | Lists databases and inspects schemas, modules and tables, or compares two databases. |
| rehearsal_manage | Runs and tracks upgrade rehearsals on disposable database copies. |
| migration_audit | Runs migration health checks and retrieves reports. |
| job_manage | Lists, runs, checks and cancels declared script jobs. |
| gitlab_repo | Browses allowlisted GitLab projects, refs, files and commits. |
| gitlab_items | Lists, reads and creates issues and merge requests. |
| gitlab_ci | Reads pipelines and job logs, and retries, cancels or triggers them. |
| gitlab_deploy | Lists deploy targets and deploys or rolls back from GitLab. |
| memory_manage | Searches and saves shared notes and decisions in persistent memory. |
{
"mcpServers": {
"vps": {
"command": "uvx",
"args": [
"steward-mcp",
"serve",
"--config",
"/absolute/path/to/.config/vps-mcp/myvps.toml"
]
}
}
}Prepare the VPS user, sudoers profile, pinned host key and TOML policy file first. Use absolute paths, since GUI apps do not inherit your shell PATH.
| Variable | Description | Required |
|---|---|---|
| VPS_MCP_MODE | Set to full to expose the granular 45-tool catalogue instead of the default compact surface. | Optional |
Run an Actual Budget ledger from your AI agent, with phone approvals for every change on paired machines.
An Odoo module that serves a read-only MCP endpoint at /mcp, scoped to each user's own access rights.
A Markdown notes and drawings app with a built-in MCP server that lets AI apps search and edit your vault, with no deletes.
Search, read and, with permission, edit the notes in your local monthlet vault from Claude and other MCP clients.
A desktop downloader and toolbox that coding agents can drive locally: queue media, read files, check ports.
Agent memory that keeps every correction with its history, plus saved working state so a crashed run can resume.