Máy Chủ MCP Terminal Controller

Máy chủ MCP “Terminal Controller” làm gì?

Máy chủ MCP Terminal Controller là một máy chủ Model Context Protocol (MCP) được thiết kế để cho phép thực thi lệnh terminal, di chuyển thư mục và thao tác hệ thống tệp một cách an toàn thông qua giao diện chuẩn hóa. Nó đóng vai trò cầu nối giữa trợ lý AI và môi trường máy chủ, cho phép AI agent thực hiện các tác vụ như chạy lệnh shell, quản lý thư mục và thao tác file theo cách lập trình. Với các biện pháp bảo mật tích hợp, theo dõi lịch sử lệnh và khả năng tương thích đa nền tảng, Terminal Controller tăng cường quy trình phát triển bằng cách cung cấp cho công cụ AI quyền truy cập có kiểm soát vào terminal và hệ thống tệp của máy. Khả năng này cho phép trợ lý AI tự động hóa, khám phá và quản lý các tác vụ cấp hệ thống cho lập trình viên một cách an toàn và chuẩn hóa.

Danh sách Prompt

Không tìm thấy mẫu prompt trong kho lưu trữ hoặc tài liệu.

Danh sách Tài nguyên

Không có tài nguyên MCP cụ thể nào được định nghĩa trong kho lưu trữ hoặc tài liệu.

Danh sách Công cụ

• Thực thi Lệnh: Cho phép chạy lệnh terminal với kiểm soát timeout và thu thập toàn bộ đầu ra.
• Quản lý Thư mục: Hỗ trợ di chuyển và liệt kê nội dung thư mục với định dạng trực quan.
• Thao tác File: Hỗ trợ đọc, ghi, cập nhật, chèn và xóa nội dung file với độ chính xác từng dòng.
• Lịch sử Lệnh: Theo dõi và hiển thị các lệnh gần đây đã thực hiện để kiểm tra và lặp lại.

Ứng dụng của MCP Server này

• Tự động hóa Thực thi Lệnh: Lập trình viên có thể chỉ định AI agent chạy lệnh shell để build, kiểm thử hoặc deploy code một cách an toàn, với đầu ra và lỗi được thu thập.
• Quản lý Thư mục & File: AI agent hỗ trợ tổ chức, duyệt hoặc thao tác file/thư mục, giúp tự động hóa khám phá codebase hoặc thiết lập môi trường.
• Scripting chú trọng Bảo mật: Biện pháp bảo vệ tích hợp giúp tránh lệnh nguy hiểm, giảm rủi ro khi cấp quyền truy cập terminal cho AI.
• Giám sát & Kiểm toán Hệ thống: Tính năng lịch sử lệnh cho phép theo dõi các hành động đã thực hiện, hỗ trợ kiểm toán và minh bạch quy trình.
• Phát triển Đa Nền tảng: Hỗ trợ cả Windows và UNIX, MCP server giúp trải nghiệm phát triển nhất quán trên nhiều môi trường.

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

Windsurf

1. Đảm bảo đã cài đặt Python 3.11+.
2. Cài đặt gói qua PyPI:

   pip install terminal-controller
   

3. Sửa file cấu hình Windsurf để thêm MCP server:

   {
     "mcpServers": {
       "terminal-controller": {
         "command": "python",
         "args": ["-m", "terminal_controller"]
       }
     }
   }
   

4. Lưu cấu hình và khởi động lại Windsurf.
5. Kiểm tra máy chủ MCP đã hoạt động và có thể truy cập.

Claude

1. Cài đặt Python 3.11+ trên máy của bạn.
2. Đối với Claude Desktop, cài đặt qua Smithery:

   npx -y @smithery/cli install @GongRzhe/terminal-controller-mcp --client claude
   

3. Hoặc cài đặt qua PyPI:

   pip install terminal-controller
   

4. Thêm đoạn sau vào cấu hình Claude:

   {
     "mcpServers": {
       "terminal-controller": {
         "command": "python",
         "args": ["-m", "terminal_controller"]
       }
     }
   }
   

5. Khởi động lại Claude Desktop và kiểm tra MCP server đã được nhận diện.

Cursor

1. Đảm bảo đã cài đặt Node.js và Python 3.11+.
2. Cài đặt terminal-controller:

   pip install terminal-controller
   

3. Thêm MCP server vào cấu hình Cursor:

   {
     "mcpServers": {
       "terminal-controller": {
         "command": "python",
         "args": ["-m", "terminal_controller"]
       }
     }
   }
   

4. Lưu file và khởi động lại Cursor.
5. Xác nhận tích hợp bằng cách kiểm tra danh sách công cụ trong Cursor.

Cline

1. Đảm bảo Python 3.11+ đã sẵn sàng.
2. Cài đặt MCP server:

   pip install terminal-controller
   

3. Thêm đoạn sau vào cấu hình Cline:

   {
     "mcpServers": {
       "terminal-controller": {
         "command": "python",
         "args": ["-m", "terminal_controller"]
       }
     }
   }
   

4. Khởi động lại Cline sau khi lưu thay đổi.
5. Kiểm tra bằng cách chạy một lệnh đơn giản qua MCP.

Bảo mật API Key

Nếu cần API key hoặc secrets cho thiết lập của bạn, hãy dùng biến môi trường thay vì ghi trực tiếp. Ví dụ cấu hình:

{
  "mcpServers": {
    "terminal-controller": {
      "command": "python",
      "args": ["-m", "terminal_controller"],
      "env": {
        "MY_API_KEY": "${MY_API_KEY_ENV_VAR}"
      },
      "inputs": {
        "api_key": "${MY_API_KEY_ENV_VAR}"
      }
    }
  }
}

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

Sử dụng MCP trong FlowHunt

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

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, nhập thông tin máy chủ MCP của bạn theo định dạng JSON sau:

{
  "terminal-controller": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Sau khi cấu hình, AI agent sẽ có thể sử dụng MCP này như một công cụ với đầy đủ chức năng. Hãy nhớ thay “terminal-controller” bằng tên thực tế của MCP server và thay URL thành địa chỉ MCP server của bạn.

Tổng quan

Dựa trên các thông tin trên, Terminal Controller MCP cung cấp quyền truy cập terminal và hệ thống tệp thiết yếu một cách an toàn nhưng thiếu các template prompt và tài nguyên rõ ràng. Tài liệu cấu hình đầy đủ và đa nền tảng. Roots và sampling không được đề cập. Tổng thể, đây là một máy chủ thực tiễn, an toàn, phù hợp cho các nhu cầu DevOps hoặc tự động hóa cốt lõi.

MCP Score