VPS MCP Server

An MCP server that enables an AI agent to connect to and control a VPS (Virtual Private Server) via SSH.

Tools

Session Management

• connect_vps: Establish SSH connection (Host, Port, User, Password/Key).

• disconnect_vps: Close the session.

File System Operations

• 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.

Command Execution

• 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.

Usage

Add the following configuration to your MCP client (e.g., Claude Desktop config file):

{
  "mcpServers": {
    "vps": {
      "command": "npx",
      "args": ["-y", "vps-mcp"]
    }
  }
}

Support

If you find this project useful, consider supporting me on Patreon:

or click here to donate.