ssh-mcp-vn 0.1.0

High-performance SSH & SFTP MCP Server for Linux

SSH & SFTP MCP Server (ssh-mcp-vn)

Một MCP (Model Context Protocol) Server mạnh mẽ dùng để thực thi lệnh (SSH) và truyền tải file (SFTP) trên nhiều máy chủ Linux từ xa (multi-host) cùng lúc.

Hướng dẫn cài đặt

Chạy qua UVX (Được khuyến nghị)

Bạn có thể chạy trực tiếp server này qua uvx mà không cần phải tải hay cài đặt thủ công:

uvx ssh-mcp-vn

Các tính năng chính

• Hỗ trợ Multi-host: Có thể tương tác với nhiều máy chủ Linux mà không cần chạy nhiều instance.
• Thực thi qua SSH: Chạy lệnh bash/shell tùy ý trên máy chủ từ xa.
• Quản lý thư mục: Dễ dàng tạo cấu trúc thư mục từ xa (hoạt động giống lệnh mkdir -p).
• Tải lên qua SFTP: Đẩy file từ máy tính cá nhân lên máy chủ từ xa.
• Tải về qua SFTP: Tải file từ máy chủ từ xa về máy tính.
• Liệt kê file bằng SFTP: Xem danh sách các file trong một thư mục bất kỳ trên máy chủ.

Cấu hình

MCP server này hỗ trợ nhận cấu hình dạng một chuỗi JSON (JSON string) qua biến môi trường SSH_SERVERS. Trong file mcp_config.json, bạn cấu hình theo định dạng như sau:

{
  "mcpServers": {
    "ssh-server": {
      "command": "uvx",
      "args": [
        "ssh-mcp-vn"
      ],
      "env": {
        "SSH_SERVERS": "[{\"host\":\"192.168.1.100\", \"user\":\"root\", \"password\":\"mat_khau_1\", \"port\":22}, {\"host\":\"192.168.1.101\", \"user\":\"ubuntu\", \"key_path\":\"/path/to/key.pem\"}]"
      }
    }
  }
}

Các trường trong mảng JSON cấu hình

Trong mảng JSON cấu hình (SSH_SERVERS), mỗi object hỗ trợ các trường sau:

• host (bắt buộc): Địa chỉ IP hoặc Hostname của máy chủ SSH.
• user (bắt buộc): Tên đăng nhập (username).
• port (tùy chọn): Cổng SSH, mặc định là 22.
• password (tùy chọn): Mật khẩu đăng nhập.
• key_path (tùy chọn): Đường dẫn tuyệt đối đến file khóa bí mật (private key) nếu dùng key để đăng nhập.

Danh sách công cụ (Tools)

(Tất cả các công cụ đều yêu cầu tham số host để hệ thống biết sẽ thao tác trên máy chủ nào).

• ssh_execute_command: Chạy một lệnh shell trên máy Linux từ xa.
• ssh_create_folder: Tạo thư mục từ xa.
• sftp_upload_file: Chuyển một file từ local lên máy chủ.
• sftp_download_file: Lấy một file từ máy chủ về local.
• sftp_list_directory: Liệt kê tất cả file trong một thư mục từ xa.

License

MIT