ssh-mcp-server: SSH Từ Xa An Toàn cho Quy Trình AI

Máy chủ MCP “ssh-mcp-server” làm gì?

ssh-mcp-server là một công cụ cầu nối cho phép các trợ lý AI và ứng dụng hỗ trợ Model Context Protocol (MCP) thực thi lệnh SSH từ xa thông qua giao diện tiêu chuẩn. Bằng cách hoạt động như một trung gian an toàn, nó giúp trợ lý AI vận hành máy chủ từ xa, thực thi lệnh và nhận kết quả mà không cần tiết lộ trực tiếp thông tin xác thực SSH cho mô hình AI. Máy chủ hỗ trợ nhiều phương thức kết nối SSH an toàn, bao gồm xác thực bằng mật khẩu hoặc khoá riêng (có thể thêm passphrase). Nó còn cung cấp kiểm soát bảo mật lệnh thông qua blacklist và whitelist, đồng thời cho phép truyền tập tin hai chiều giữa máy chủ cục bộ và từ xa. ssh-mcp-server được thiết kế để tích hợp mượt mà vào quy trình phát triển, cung cấp cho dev và AI agent quyền truy cập mạnh mẽ nhưng kiểm soát vào hệ thống từ xa cho các tác vụ bảo trì, tự động hoá, và triển khai.

Danh sách Prompt

Không có mẫu prompt nào được đề cập rõ ràng trong tài liệu hiện có.

Danh sách Tài nguyên

Không có tài nguyên cụ thể nào được ghi nhận trong tệp hoặc README hiện có.

Danh sách Công cụ

• execute-command
  Công cụ Thực Thi Lệnh: Thực thi lệnh SSH trên máy chủ từ xa và nhận kết quả.
• upload
  Công cụ Tải Lên Tập Tin: Tải tập tin từ máy tính lên vị trí chỉ định trên máy chủ từ xa.
• download
  Công cụ Tải Về Tập Tin: Tải tập tin từ máy chủ từ xa về vị trí chỉ định ở máy cục bộ.

Các Trường Hợp Sử Dụng Máy Chủ MCP này

• Quản Lý Máy Chủ Từ Xa
  Cho phép dev hoặc AI agent thực thi lệnh quản trị hoặc bảo trì trên máy chủ từ xa một cách an toàn, ví dụ như khởi động lại dịch vụ, kiểm tra log hoặc cập nhật phần mềm.
• Triển Khai Tự Động
  Hỗ trợ quy trình CI/CD tự động bằng cách cho phép script hoặc AI workflow đẩy mã, chạy script setup hoặc quản lý ứng dụng qua SSH.
• Đồng Bộ Tập Tin
  Hỗ trợ truyền tập tin hai chiều, giúp dễ dàng upload file cấu hình hoặc download log, kết quả từ máy chủ từ xa.
• Kiểm Tra Bảo Mật
  Cho phép thực thi lệnh kiểm tra bảo mật có kiểm soát (whitelist/blacklist), đảm bảo kiểm tra an toàn mà không gây hại hệ thống.
• Cách Ly Thông Tin Xác Thực
  Đảm bảo vận hành an toàn bằng cách không bao giờ tiết lộ thông tin SSH cho mô hình AI, giảm thiểu rủi ro trong môi trường nhạy cảm.

Cách thiết lập

Windsurf

1. Điều kiện tiên quyết: Đảm bảo bạn đã cài đặt Node.js và npx.
2. Tìm tệp cấu hình: Mở tệp cấu hình Windsurf của bạn.
3. Thêm Máy Chủ MCP: Thêm đoạn JSON sau vào object mcpServers:

   {
     "mcpServers": {
       "ssh-mpc-server": {
         "command": "npx",
         "args": [
           "-y",
           "@fangjunjie/ssh-mcp-server",
           "--host 192.168.1.1",
           "--port 22",
           "--username root",
           "--password pwd123456"
         ]
       }
     }
   }
   

4. Lưu và khởi động lại: Lưu tệp và khởi động lại Windsurf.
5. Kiểm tra thiết lập: Thử chạy một lệnh SSH đơn giản qua MCP.

Claude

1. Điều kiện tiên quyết: Node.js và npx cần khả dụng.
2. Tìm tệp cấu hình: Mở cấu hình mcpServers của Claude.
3. Thêm Máy Chủ MCP: Sử dụng cấu hình sau:

   {
     "mcpServers": {
       "ssh-mpc-server": {
         "command": "npx",
         "args": [
           "-y",
           "@fangjunjie/ssh-mcp-server",
           "--host 192.168.1.1",
           "--port 22",
           "--username root",
           "--privateKey ~/.ssh/id_rsa"
         ]
       }
     }
   }
   

4. Lưu và khởi động lại: Lưu thay đổi và khởi động lại Claude.
5. Kiểm tra thiết lập: Thử lệnh qua tích hợp MCP của Claude.

Cursor

1. Điều kiện tiên quyết: Cài đặt Node.js và npx.
2. Chỉnh sửa cấu hình: Vào thư mục cấu hình Cursor và chỉnh sửa tệp phù hợp.
3. Thêm Máy Chủ MCP: Dán đoạn sau:

   {
     "mcpServers": {
       "ssh-mpc-server": {
         "command": "npx",
         "args": [
           "-y",
           "@fangjunjie/ssh-mcp-server",
           "--host 192.168.1.1",
           "--port 22",
           "--username root",
           "--privateKey ~/.ssh/id_rsa",
           "--passphrase pwd123456"
         ]
       }
     }
   }
   

4. Khởi động lại Cursor: Lưu và khởi động lại Cursor.
5. Xác minh: Dùng palette lệnh MCP để kiểm tra kết nối SSH từ xa.

Cline

1. Điều kiện tiên quyết: Đảm bảo đã cài đặt Node.js và npx.
2. Mở cấu hình: Chỉnh sửa phần mcpServers trong cấu hình Cline.
3. Thêm Máy Chủ MCP: Thêm đoạn sau:

   {
     "mcpServers": {
       "ssh-mpc-server": {
         "command": "npx",
         "args": [
           "-y",
           "@fangjunjie/ssh-mcp-server",
           "--host 192.168.1.1",
           "--port 22",
           "--username root",
           "--password pwd123456",
           "--whitelist ^ls( .*)?,^cat .*,^df.*"
         ]
       }
     }
   }
   

4. Lưu và khởi động lại: Lưu cấu hình và khởi động lại Cline.
5. Kiểm tra kết nối: Thử thực thi lệnh được phép.

Bảo Mật Khoá API

Để tránh lộ thông tin xác thực trong file cấu hình, hãy sử dụng biến môi trường:

{
  "mcpServers": {
    "ssh-mpc-server": {
      "command": "npx",
      "args": [
        "-y",
        "@fangjunjie/ssh-mcp-server",
        "--host ${SSH_HOST}",
        "--port ${SSH_PORT}",
        "--username ${SSH_USER}",
        "--password ${SSH_PASSWORD}"
      ],
      "env": {
        "SSH_HOST": "192.168.1.1",
        "SSH_PORT": "22",
        "SSH_USER": "root",
        "SSH_PASSWORD": "pwd123456"
      }
    }
  }
}

Cách sử dụng MCP này trong flow

Sử dụng MCP trong FlowHunt

Để tích hợp máy chủ MCP vào quy trình FlowHunt, hãy bắt đầu bằng cách thêm thành phần MCP vào flow và kết nối nó với agent AI của bạn:

Nhấn vào thành phần MCP để mở bảng cấu hình. Trong phần cấu hình MCP hệ thống, dán thông tin máy chủ MCP của bạn theo định dạng JSON sau:

{
  "ssh-mpc-server": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Sau khi cấu hình, agent AI sẽ có thể sử dụng MCP này như một công cụ với đầy đủ chức năng. Lưu ý thay “ssh-mpc-server” thành tên máy chủ MCP thực tế của bạn và cập nhật URL.

Tổng quan

Đánh giá của chúng tôi

ssh-mcp-server cung cấp đầy đủ tính năng SSH cần thiết dưới dạng máy chủ MCP, tập trung vào bảo mật và tiện dụng. Bộ công cụ thực tế, phù hợp nhiều kịch bản phát triển và tự động hóa, nhưng thiếu các tính năng nâng cao như tài nguyên, mẫu prompt hoặc sampling. Tài liệu rõ ràng cho việc thiết lập và vận hành. Tổng thể, đây là tiện ích chuyên biệt, vững chắc cho truy cập SSH an toàn qua MCP.

Điểm MCP

ĐIỂM: 5/10

ssh-mcp-server đạt điểm trung bình, nổi bật về tích hợp SSH an toàn và cung cấp công cụ cốt lõi, nhưng thiếu hỗ trợ tài nguyên, prompt và không tài liệu về root hoặc sampling. Giấy phép mã nguồn mở và thiết lập rõ ràng là điểm mạnh, song nó vẫn là giải pháp MCP chuyên biệt thay vì toàn diện.