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

1. Build the project:

   npm install npm run build

2. Run the server (via MCP client configuration):

   { "mcpServers": { "vps": { "command": "node", "args": ["/path/to/vps-mcp/dist/index.js"] } } }

Support

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

or click here to donate.