VPS Ops
Stdio MCP server that inspects and (with confirmation) mutates one VPS over SSH.
Connector by koller-nexus · GitHub account verified by the MCP Registry
Install
Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.
npx agentmarket install connector/koller-nexus-vps-ops-mcp
Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.
Get the weekly diff
The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.
About
Reviews
Write a reviewNo reviews yet. Installed it? Reviews come from verified installers only. How reviews work
Permissions
What this server can do and what it asks for, from its tool list and install config. Checked Oct 25, 2026.
- Tools
- 8 read · 8 write · 1 delete · 10 not yet classified
- Secrets
- 2 (API keys, tokens or passwords)
- Install scripts
- Not scanned yet
- Runs as
- Node.js package
Tools by what they do 27
Read from the source code; the running server may list different tools.
Read 8 · Look things up without changing anything.
docker_inspectdocker_node_lsdocker_psdocker_service_lsdocker_statsssh_hardening_checkvps_journalvps_ping
Write 8 · Create, change, send or run things.
compose_config_varscompose_pscompose_pull_upcompose_restartcompose_updocker_restartdocker_startdocker_stop
Delete 1 · Delete, drop, revoke or wipe things.
docker_rm
Not yet classified 10 · We could not tell from the name and description.
disk_cleanup_dockerdocker_logshost_depshost_dmesghost_fail2banhost_failed_unitshost_firewallhost_listenhost_topvps_resources
Secrets and settings it asks for
Secrets: values you paste in that let it act as you.
VPS_SSH_KEY_PASSPHRASEVPS_SSH_KEY_PATH
Other settings (environment variables or headers).
VPS_ALLOW_MUTATIONSVPS_COMMAND_TIMEOUT_MSVPS_COMPOSE_DIRVPS_HOSTVPS_LOG_MAX_BYTESVPS_PORTVPS_USER
Files it touches
- Any path the agent passes to its tools
Tools (27)
Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].
compose_config_varsRender the stack (docker compose config) and return only environment variable names per service, never values.
compose_psdocker compose ps in dir (arg or VPS_COMPOSE_DIR), optional file.
compose_pull_updocker compose pull then up -d [services…]. Requires confirm:true.
compose_restartdocker compose restart [services…]. Requires confirm:true.
compose_updocker compose up -d [services…]. Requires confirm:true. dir or VPS_COMPOSE_DIR.
disk_cleanup_dockerdocker system prune -f; volumes only if confirm_volumes:true. Requires confirm:true.
docker_inspectdocker inspect on a container/image name.
docker_logsdocker logs --tail N --timestamps. Optional since. N <= 1000.
docker_node_lsList Docker Swarm nodes as JSON lines (fallback to table).
docker_psList all Docker containers as JSON lines (fallback to table).
docker_restartdocker restart NAME. Requires confirm:true.
docker_rmdocker rm -f NAME. Requires confirm:true AND force_name === name.
docker_service_lsList Docker Swarm services as JSON lines (fallback to table).
docker_startdocker start NAME. Requires confirm:true.
docker_statsOne-shot docker stats --no-stream.
Show 12 more tools
docker_stopdocker stop NAME. Requires confirm:true.
host_depsVersions of docker, docker compose (v2 plugin) and jq on the VPS.
host_dmesgKernel log tail via dmesg -T. N <= 200. sudo -n, then fallback without sudo.
host_fail2banfail2ban-client status; optional jail (default overall, or sshd).
host_failed_unitsFailed systemd units (systemctl --failed --no-pager).
host_firewallufw status verbose (sudo -n, then fallback without sudo).
host_listenListening TCP/UDP sockets (ss -lntup). sudo -n, then fallback without sudo.
host_topTop 30 processes by memory (ps aux --sort=-%mem).
ssh_hardening_checkEffective sshd settings: port, passwordauthentication, permitrootlogin, pubkeyauthentication.
vps_journalRead systemd journal for an allowlisted unit (or *.service). N <= 500.
vps_pingHealth check: uname -a, uptime, and hostname on the VPS via SSH.
vps_resourcesDisk (df -h), memory (free -h), and load average.
Signals
- Stars
- 1
- Forks
- 1
- Open issues
- 0
- Weekly downloads
- 32
- Last commit
- Oct 13, 2026 (15 days ago)
- Last release
- Sep 22, 2026 (1 month ago)
- Last package publish
- Oct 13, 2026 (15 days ago)
From GitHub (fetched Oct 24, 2026) and the package registry.
Details
- Registry name
io.github.koller-nexus/vps-ops-mcp- Version
- 0.1.0
- Auth
- API key
- Packages
- npm @koller-nexus/vps-ops-mcp
- License
- MIT
- Repository
- github.com/koller-nexus/vps-ops-mcp
- First seen
- Oct 24, 2026
- Last checked
- Oct 24, 2026
Cite this page
VPS Ops MCP server. Agent Mart. https://agentmart.dev/connectors/koller-nexus-vps-ops-mcp (last updated 2026-10-24)