Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@VPS MCP Server List the files in my home directory and check the current disk usage"
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.
An MCP server that enables an AI agent to connect to and control a VPS (Virtual Private Server) via SSH.
connect_vps: Establish SSH connection (Host, Port, User, Password/Key).
disconnect_vps: Close the session.
list_directory: List files/folders in a path (supports relative paths to CWD).
create_directory: Create a new directory.
read_file: Read file contents.
write_file: Create or overwrite a file with content.
delete_item: Recursively delete a file or directory.
change_directory: Change the current working directory for subsequent commands.
get_current_directory: Get the current tracked working directory.
execute_command: Run shell commands.
Note: Commands are automatically prefixed with cd <current_working_directory>.
To change directory persistently, use change_directory instead of running cd here.
Related MCP server: MCP VPS Manager
Add the following configuration to your MCP client (e.g., Claude Desktop config file):
{
"mcpServers": {
"vps": {
"command": "npx",
"args": ["-y", "vps-mcp"]
}
}
}If you find this project useful, consider supporting me on Patreon:
or click here to donate.
Change the current working directory on the VPS.
Inputs: path (required).
Connect to a VPS using SSH. Requires host, username, and either password or privateKey.
Inputs: host (required), username (required), port, password, +1 more.
Create a new directory on the VPS.
Inputs: path (required).
Delete a file or directory on the VPS (recursive).
Inputs: path (required).
Disconnect from the current VPS session.
Inputs: no named parameters.
Execute a shell command on the connected VPS and return the output. Runs in the current tracked directory.
Inputs: command (required).
Get the current working directory path.
Inputs: no named parameters.
List contents of a directory on the VPS. Defaults to current working directory.
Inputs: path.
Read the contents of a file on the VPS.
Inputs: path (required).
Create or overwrite a file on the VPS.
Inputs: path (required), content (required).
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 10 tools
Each tool has a clearly distinct purpose with no ambiguity. For example, change_directory modifies the working directory while get_current_directory retrieves it, and list_directory shows contents while read_file reads file data. The actions (change, connect, create, delete, etc.) and targets (directory, VPS, file) are consistently differentiated.
All tool names follow a consistent verb_noun pattern with snake_case throughout. Examples include change_directory, execute_command, and list_directory. There are no deviations in naming conventions, making the set predictable and readable.
With 10 tools, the count is well-scoped for managing a VPS via SSH. Each tool earns its place by covering essential operations like connection management, file system navigation, and command execution, without being excessive or insufficient for the domain.
The tool set provides strong coverage for core VPS management tasks, including connection handling, file CRUD operations, and directory navigation. A minor gap is the lack of tools for advanced operations like file permissions management or process monitoring, but agents can work around this using execute_command.
Manage servers through SSH.
Work on your own computers from Claude or ChatGPT: run commands, edit and search files.
Scoped, audited SSH exec, sessions, and SFTP on your saved servers without exposing credentials
Manage remote servers, SSH terminals, files, databases and proxies with scoped access and approvals.
