Which integrations are available for this server?

Manage Docker containers — list, start, stop, restart, logs, stats, images

How do I use vps-mcp-server?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@vps-mcp-server Restart nginx and show recent logs" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

vps-mcp-server

by harbouli

Overview Schema Source Related Servers Discussions Admin

TypeScript

Remote

🖥️ VPS MCP Server

An MCP (Model Context Protocol) server that gives AI assistants full control over a VPS via SSH. Execute commands, manage files, control services, monitor resources, manage Docker containers, and configure firewalls — all through a secure SSH tunnel.

✨ Features

Tool	Description
`run_command`	Execute any shell command on the VPS
`read_file`	Read file contents via SFTP
`write_file`	Create or overwrite files via SFTP
`list_directory`	List directory contents with detailed info
`manage_service`	Start, stop, restart, reload, enable, disable systemd services & view logs
`list_services`	List systemd services filtered by state (running, failed, enabled)
`system_stats`	Get CPU, memory, disk, network, uptime, and process stats
`docker`	Manage Docker containers — list, start, stop, restart, logs, stats, images
`firewall`	Manage UFW rules — status, allow, deny, delete, reset

Related MCP server: MCP VPS Manager

📦 Installation

# Clone the repository
git clone https://github.com/your-username/vps-mcp-server.git
cd vps-mcp-server

# Install dependencies
pnpm install

# Build
pnpm build

⚙️ Configuration

Create a .env file from the example:

cp .env.example .env

Set the following environment variables:

Variable	Required	Default	Description
`VPS_HOST`	✅	—	Hostname or IP of your VPS
`VPS_USER`	✅	—	SSH username
`VPS_KEY_PATH`	✅	—	Absolute path to your SSH private key
`VPS_PORT`	❌	`22`	SSH port
`VPS_KEY_PASSPHRASE`	❌	—	Passphrase for the SSH key (if encrypted)

Example .env:

VPS_HOST=203.0.113.10
VPS_USER=deploy
VPS_KEY_PATH=/Users/you/.ssh/id_ed25519
VPS_PORT=22

🚀 Usage

With Claude Desktop / Gemini CLI / Any MCP Client

Add the server to your MCP client configuration:

{
  "mcpServers": {
    "vps": {
      "command": "node",
      "args": ["/absolute/path/to/vps-mcp-server/dist/index.js"],
      "env": {
        "VPS_HOST": "203.0.113.10",
        "VPS_USER": "deploy",
        "VPS_KEY_PATH": "/Users/you/.ssh/id_ed25519"
      }
    }
  }
}

Development Mode

pnpm dev

Production

pnpm build
pnpm start

🛠️ Tools Reference

`run_command`

Execute a shell command on the VPS.

Parameter	Type	Required	Default	Description
`command`	`string`	✅	—	The shell command to execute
`timeout`	`number`	❌	`30000`	Timeout in milliseconds
`working_directory`	`string`	❌	—	Directory to run the command in

Returns: JSON with exit_code, stdout, and stderr.

`read_file`

Read the contents of a file on the VPS via SFTP.

Parameter	Type	Required	Default	Description
`path`	`string`	✅	—	Absolute path to the file
`max_lines`	`number`	❌	—	Max lines to return (omit for full file)

`write_file`

Write content to a file on the VPS via SFTP.

Parameter	Type	Required	Default	Description
`path`	`string`	✅	—	Absolute path to the file
`content`	`string`	✅	—	Content to write
`create_dirs`	`boolean`	❌	`false`	Create parent directories if missing

`list_directory`

List files and directories at a given path.

Parameter	Type	Required	Default	Description
`path`	`string`	❌	`/`	Directory path to list
`show_hidden`	`boolean`	❌	`false`	Include dotfiles
`long_format`	`boolean`	❌	`true`	Show permissions, size, date

`manage_service`

Manage systemd services.

Parameter	Type	Required	Default	Description
`service`	`string`	✅	—	Service name (e.g., `nginx`)
`action`	`enum`	✅	—	`start` \| `stop` \| `restart` \| `reload` \| `status` \| `enable` \| `disable` \| `logs`
`log_lines`	`number`	❌	`50`	Lines to show (for `logs` action)

`list_services`

List systemd services filtered by state.

Parameter	Type	Required	Default	Description
`filter`	`enum`	❌	`running`	`all` \| `running` \| `failed` \| `enabled`

`system_stats`

Get system resource usage.

Parameter	Type	Required	Default	Description
`include`	`array`	❌	`["all"]`	`cpu` \| `memory` \| `disk` \| `network` \| `uptime` \| `processes` \| `all`

`docker`

Manage Docker containers.

Parameter	Type	Required	Default	Description
`action`	`enum`	✅	—	`ps` \| `start` \| `stop` \| `restart` \| `logs` \| `stats` \| `images`
`container`	`string`	❌	—	Container name/ID (required for `start`/`stop`/`restart`/`logs`)
`log_lines`	`number`	❌	`50`	Lines to show (for `logs` action)

`firewall`

Manage UFW firewall rules.

Parameter	Type	Required	Default	Description
`action`	`enum`	✅	—	`status` \| `allow` \| `deny` \| `delete` \| `reset`
`rule`	`string`	❌	—	Rule spec (e.g., `80/tcp`, `443`, `from 10.0.0.1`)

📁 Project Structure

src/
├── index.ts            # Server bootstrap & lifecycle
├── ssh.ts              # SSHManager class (connection pooling)
├── types.ts            # Shared TypeScript types
├── helpers.ts          # Response helper functions
└── tools/
    ├── index.ts         # Tool registration barrel
    ├── run-command.ts   # Shell command execution
    ├── read-file.ts     # SFTP file reading
    ├── write-file.ts    # SFTP file writing
    ├── list-directory.ts
    ├── manage-service.ts
    ├── list-services.ts
    ├── system-stats.ts
    ├── docker.ts
    └── firewall.ts

🔒 Security Notes

The server connects via SSH using key-based authentication (no passwords).
Commands run with the privileges of the configured SSH user.
Service management and firewall tools use sudo — ensure your SSH user has appropriate sudoers permissions.
The server maintains a persistent SSH connection that is automatically reconnected if dropped.

📄 License

MIT

Available Tools

9 tools

dockerC

Manage Docker containers (list, start, stop, logs, stats)

Inputs: action (required), container, log_lines.

firewallC

Manage UFW firewall rules (status, allow, deny, delete)

Inputs: action (required), rule.

list_directoryA

List files and directories at a given path on the VPS

Inputs: path, long_format, show_hidden.

list_servicesA

List all systemd services or filter by state

Inputs: filter.

manage_serviceB

Manage systemd services on the VPS (start, stop, restart, status, enable, disable)

Inputs: action (required), service (required), log_lines.

read_fileA

Read the contents of a file on the VPS

Inputs: path (required), max_lines.

run_commandB

Execute a shell command on the VPS via SSH

Inputs: command (required), timeout, working_directory.

system_statsB

Get system resource usage (CPU, RAM, disk, network, uptime)

Inputs: include.

write_fileA

Write content to a file on the VPS (creates or overwrites)

Inputs: path (required), content (required), create_dirs.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

Deploy Server

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

A3.6/5.0

Scored 2026-08-09 22:10 across 9 tools

Disambiguation5/5

Each tool targets a distinct resource or action: file operations, directory listing, command execution, service management, system stats, Docker, and firewall. The run_command tool is a catch-all but has a clearly separate purpose as an arbitrary command executor.

Naming Consistency4/5

Most tools follow a verb_noun pattern (e.g., read_file, manage_service), but 'docker' and 'firewall' are bare nouns, and 'system_stats' is noun_noun. These are minor deviations that don't impede comprehension.

Tool Count5/5

With 9 tools, the set is well-scoped for VPS management. Each tool covers a distinct area without redundancy or bloat, fitting comfortable within the ideal range.

Completeness4/5

The set covers core operations: file read/write/list, command execution, service management, system stats, Docker, and firewall. Missing file deletion/renaming and some advanced administrative tasks, but the surface is sufficient for common VPS workflows.

Maintenance

ActivityInactive

ResponsivenessNo recent community issues

Resources

Related MCP Connectors

Vozora
io.vozora
Manage Vozora VPS servers, SSH keys, firewalls, DNS and usage from an AI agent.
Cloud Platforms Networking & Infrastructure Security
1
https://mcp.vozora.io/mcp
emisar
dev.emisar
Let AI operate servers without SSH. Choose actions, approve risky changes, and audit every step.
Cloud Platforms Security Networking & Infrastructure
2375
https://emisar.dev/api/mcp/rpc
SentinelX MCP
app.sentinelx
Operate Linux, macOS and Windows from your LLM. Every action runs through an auditable allowlist.
Shell Access OS Automation
216
https://mcp.sentinelx.app/mcp/mcp
ShellwayB
com.getshellway
Work on your own computers from Claude or ChatGPT: run commands, edit and search files.
Command Line Developer Tools Networking & Infrastructure
301
https://mcp.getshellway.com/mcp

Related MCP Servers

VPS MCP Server
Shell Access Virtualization File Systems
HarjjotSinghh
A
license
A
quality
D
maintenance
Enables AI agents to connect to and control a Virtual Private Server via SSH. It provides a comprehensive suite of tools for remote file system operations, session management, and shell command execution.
Updated 10 months ago (2026-01-18 15:51 UTC)
10
17 npm
2
ISC
MCP VPS Manager
Shell Access Virtualization Monitoring
ARMeeru
A
license
Not graded
quality
D
maintenance
Enables LLMs to securely manage Virtual Private Servers via SSH, with features including command execution, file operations, system monitoring, and service management.
Updated a year ago (2025-08-23 03:08 UTC)
2
MIT
SSH MCP Server
Shell Access File Systems
uarlouski
A
license
Not graded
quality
D
maintenance
Enables AI assistants to securely execute commands, transfer files, and manage port forwarding on remote servers via SSH.
Updated 5 months ago (2026-06-10 10:12 UTC)
158 npm
38
Apache 2.0
remote-admin-mcp
Shell Access Command Line
intershopper
A
license
A
quality
B
maintenance
Enables AI assistants to manage remote servers via SSH with agentless command execution, file operations, and service management.
Updated a month ago (2026-10-03 11:34 UTC)
9
MIT

🖥️ VPS MCP Server

✨ Features

📦 Installation

⚙️ Configuration

🚀 Usage

With Claude Desktop / Gemini CLI / Any MCP Client

Development Mode

Production

🛠️ Tools Reference

run_command

read_file

write_file

list_directory

manage_service

list_services

system_stats

docker

firewall