VPS MCP Server 🚀

English | 中文说明

English Description

An advanced Model Context Protocol (MCP) server designed to turn your VPS into a powerful AI-driven remote workstation. It provides a comprehensive set of tools for command execution, file management, system monitoring, and persistent session handling.

🌟 Key Features

• Command Execution: Run shell commands and scripts (Python/Node/Bash) in a sandboxed environment.

• Advanced File Management: Read, write, patch, search, and visualize directory trees.

• Persistent Sessions: Based on tmux, allowing AI to handle long-running or interactive tasks.

• System Monitoring: Real-time process listing and system resource tracking.

• Network Capabilities: Make HTTP requests or download large files directly to the VPS.

• Flexible Transport: Supports both stdio and SSE (HTTP) modes.

⚡️ Quick Run with npx

You can run the server directly without cloning the repository:

# stdio mode (for local use)
npx github:zhy1369800/vps-mcp-server

# SSE mode (for remote VPS deployment)
MODE=sse PORT=8080 MCP_TOKEN=your-token npx github:zhy1369800/vps-mcp-server

🛠 Tools Reference

🚀 Manual Installation

1. Clone & Install:

   git clone https://github.com/zhy1369800/vps-mcp-server.git
   cd vps-mcp-server
   npm install

2. Build:

   npm run build

3. Configure: Copy .env.example to .env and set your MCP_TOKEN.

4. Run (SSE Mode):

   MODE=sse PORT=8080 npm start

Related MCP server: interminal

中文说明

这是一个先进的 Model Context Protocol (MCP) 服务端，旨在将您的 VPS 变成一个强大的 AI 驱动远程工作站。它为 AI Agent 提供了完整的指令执行、文件管理、系统监控和持久化会话处理工具集。

🌟 核心特性

• 指令执行：在沙箱环境中运行 Shell 命令和脚本（Python/Node/Bash）。

• 高级文件管理：支持读取、写入、增量补丁（Patch）、全文搜索及目录树可视化。

• 持久化会话：基于 tmux 实现，允许 AI 处理耗时较长或需要交互的任务。

• 系统监控：实时查看进程列表、CPU、内存及磁盘占用情况。

• 网络增强：直接从 VPS 发起 HTTP 请求或下载大文件到磁盘。

• 双模式支持：支持 stdio 本地调用和 SSE (HTTP) 远程调用模式。

⚡️ 使用 npx 快速运行

无需克隆代码即可直接启动服务：

# stdio 模式 (本地使用)
npx github:zhy1369800/vps-mcp-server

# SSE 模式 (远程 VPS 部署)
MODE=sse PORT=8080 MCP_TOKEN=your-token npx github:zhy1369800/vps-mcp-server

🛠 工具列表

🚀 手动安装步骤

1. 克隆与安装：

   git clone https://github.com/zhy1369800/vps-mcp-server.git
   cd vps-mcp-server
   npm install

2. 编译：

   npm run build

3. 配置环境： 将 .env.example 复制为 .env 并设置您的 MCP_TOKEN。

4. 启动服务 (SSE 模式)：

   MODE=sse PORT=8080 npm start

🛡 安全建议

建议在 Docker 容器中运行此服务，并配合 Nginx 反向代理（配置 SSL 证书）以确保通信安全。

📄 开源协议

MIT