TopGit
Đánh giá repo GitHub

Desktop Commander MCP: Điều khiển terminal & file cho AI

wonderwhy-er/DesktopCommanderMCP

Desktop Commander MCP server là một server Model Context Protocol trao cho Claude — và bất kỳ client tương thích MCP nào — quyền điều khiển terminal, hệ thống file và việc sửa code của bạn. Nó chạy lệnh, tìm và sửa file bằng diff chính xác, thậm chí chạy Python, Node hoặc R trong bộ nhớ, tất cả điều khiển từ cửa sổ chat thay vì một editor riêng.

DDesktop Commander MCP: Điều khiển terminal & file cho AI — open-source GitHub repository preview
Nhận định nhanh

Hãy chọn Desktop Commander nếu bạn muốn cửa sổ chat AI thực sự chạy lệnh và sửa file trên máy — build, test, refactor, phân tích một file CSV — mà không trả chi phí API theo token, vì theo README nó dùng chính gói thuê bao Claude sẵn có của bạn. Bỏ qua nếu bạn thấy bất an khi trao cho AI quyền truy cập shell vào hệ thống file thật, hoặc bạn muốn ở lại trong một editor chuyên dụng như Cursor hơn là điều khiển mọi thứ từ cửa sổ chat.

Sao
★ 7.2k
Fork
⑂ 913
Người đóng góp
👥 35
Ngôn ngữ
TypeScript
Giấy phép
MIT
Chủ đề
AI Tools
Cập nhật
Jul 2026
Trang chủ
GitHub

Vấn đề nó giải quyết

Hầu hết trợ giúp lập trình bằng AI đều mắc kẹt sau một bức tường copy-paste: model gợi ý một lệnh hay một diff, còn bạn là người chạy nó, dán kết quả trở lại, rồi lặp lại. Vòng lặp đó chậm, và các agent chạy qua API còn tính phí từng token. Desktop Commander khép kín vòng đó bằng cách cho model quyền truy cập trực tiếp terminal và file qua MCP, để nó tự chạy lệnh, đọc kết quả và sửa file.

Đây là gì?

Desktop Commander MCP server là một MCP server mã nguồn mở (MIT), viết bằng TypeScript, trao cho một client AI quyền điều khiển terminal, tìm kiếm hệ thống file và sửa file bằng diff. Nó được xây trên nền MCP Filesystem Server chính thức và bổ sung việc chạy lệnh, quản lý tiến trình, chạy code trong bộ nhớ và xử lý tài liệu. Vì hoạt động qua Model Context Protocol, nó cắm được vào Claude Desktop, Claude Code, Cursor, VS Code và các client MCP khác, và theo README nó dùng gói thuê bao của client chủ thay vì một API key trả phí.

Vì sao đang được chú ý

Với 7.661 sao, Desktop Commander nằm trong mảng MCP server đang phát triển nhanh. Điểm bán hàng của nó — chạy lệnh terminal và sửa file từ gói thuê bao Claude sẵn có thay vì token API tính phí — hợp với những người muốn tự động hóa kiểu agent mà không phải trả tiền theo từng token. README cũng quảng bá một ứng dụng Desktop Commander mới hơn và chế độ Remote MCP vươn tới ChatGPT và Claude web, mở rộng nơi cùng bộ công cụ này chạy được.

Số sao GitHub của repo này thay đổi thế nào theo thời gian. Nguồn: star-history.com.Xem lịch sử sao

Tính năng chính

  • Chạy lệnh terminal với luồng output, timeout và hỗ trợ tiến trình chạy nền/dài hạn
  • Sửa file bằng diff — thay thế văn bản chính xác cho thay đổi nhỏ, ghi đè toàn bộ cho thay đổi lớn, cùng tìm kiếm code bằng ripgrep
  • Chạy code trong bộ nhớ với Python, Node.js và R mà không cần lưu script trước
  • Đọc và sửa gốc file Excel, PDF và DOCX, cùng phân tích tức thì CSV/JSON
  • Tương tác với tiến trình đang chạy — phiên SSH, database và dev server — kèm quản lý phiên
  • Tăng cường bảo mật: chặn duyệt symlink, danh sách chặn lệnh, ghi log kiểm toán và tùy chọn sandbox Docker
  • Chế độ Remote MCP để dùng từ ChatGPT, Claude web và các dịch vụ khác, không chỉ ứng dụng desktop cục bộ

Trường hợp dùng tốt nhất

  • Để Claude build một dự án, chạy test và sửa lỗi mà không phải copy-paste output terminal qua lại
  • Phân tích một file CSV, JSON hoặc Excel bằng cách yêu cầu AI nạp và xử lý nó trong bộ nhớ
  • Sửa file PDF hoặc tài liệu Word có sẵn, hoặc tạo file mới từ markdown
  • Gỡ lỗi với một tiến trình đang chạy — phiên SSH, một shell database, hoặc một dev server đang chạy
  • Chạy một quy trình dev bằng AI trên gói thuê bao Claude thay vì trả phí API theo token

Cách cài đặt / dùng thử

Cài vào Claude Desktop bằng một lệnh: `npx @wonderwhy-er/desktop-commander@latest setup`, rồi khởi động lại Claude. README ghi rõ nhiều cách khác — trình cài bash cho macOS, Smithery, một mục cấu hình `claude_desktop_config.json` thủ công, `git clone` cục bộ + `npm run setup`, và một tùy chọn Docker không cần Node.js. Với Claude Code, chạy `claude mcp add --scope user desktop-commander -- npx -y @wonderwhy-er/desktop-commander@latest`. Gỡ cài bằng `npx @wonderwhy-er/desktop-commander@latest remove`.

Cách sử dụng

Sau khi cài, bạn nói chuyện với client AI như bình thường và nó gọi các tool của Desktop Commander khi cần — chạy một lệnh terminal, tìm trong một thư mục, hoặc sửa một file bằng diff. README có sẵn các đoạn cấu hình cho nhiều client (Cursor, Windsurf, VS Code/Copilot, Cline, Gemini CLI, Codex và hơn nữa), tất cả dùng chung lệnh `npx -y @wonderwhy-er/desktop-commander@latest`. Lệnh chạy dài hạn có luồng output và có thể chạy nền, còn phân trang output giúp kết quả lớn không tràn context của model.

Điểm mạnh

  • Dùng gói thuê bao Claude (hoặc client khác) sẵn có thay vì token API tính phí, theo README
  • Một MCP server bao trọn terminal, hệ thống file, chạy code và tài liệu Office/PDF — bớt phải dùng nhiều tool riêng lẻ
  • Hoạt động trên nhiều client (Claude Desktop, Claude Code, Cursor, VS Code, Gemini CLI) qua cùng một cấu hình
  • Mã nguồn mở dưới MIT, có ghi log kiểm toán và một danh sách chặn lệnh bạn có thể soi
  • Nhiều cách cài, gồm một tùy chọn Docker sandbox và không cần Node.js cục bộ

Hạn chế & rủi ro

  • Trao cho AI quyền truy cập trực tiếp shell và hệ thống file vốn dĩ có rủi ro; danh sách chặn và bảo vệ symlink có ích, nhưng bạn vẫn tin model với các lệnh thật trên máy mình
  • Hầu hết cách cài cần Node.js, và cập nhật mượt nhất phụ thuộc vào tùy chọn npx hoặc Docker — bản checkout git cục bộ cần cập nhật `git pull` thủ công
  • Nó là lớp terminal/file, không phải một UI editor bóng bẩy; trải nghiệm trực quan hơn (xem trước file trực tiếp, hỗ trợ mọi model) được đẩy sang ứng dụng Desktop Commander riêng
  • Hành vi phụ thuộc vào client AI chủ và model — Desktop Commander phơi ra các tool, nhưng một tác vụ chạy tốt tới đâu vẫn tùy model điều khiển chúng
Xem trên GitHubTrang chủ

Lựa chọn thay thế

MCP Filesystem Server — MCP hệ thống file chính thức mà dự án này xây trên nền, không có phần terminal và tài liệu bổ sungClaude Code — agent lập trình chạy trên terminal của chính Anthropic, có thể tự nạp Desktop Commander như một MCP serverAider — một trợ lý lập trình AI chạy trên terminal, sửa file qua git diffcontinue — một trợ lý lập trình AI mã nguồn mở chạy bên trong VS Code và JetBrains

Ai nên thử — và ai nên bỏ qua

Lập trình viên sống trong Claude Desktop hoặc Claude Code và muốn AI thực sự chạy lệnh và sửa file — chứ không chỉ gợi ý — sẽ tận dụng Desktop Commander nhiều nhất, nhất là để tránh chi phí API theo token. Nếu bạn không thoải mái khi cấp quyền shell vào hệ thống file, hoặc bạn thích một editor chuyên dụng như Cursor hơn là điều khiển công việc từ cửa sổ chat, thì nó hợp ít hơn.

Câu hỏi thường gặp

Desktop Commander MCP là gì?

Desktop Commander là một MCP server mã nguồn mở trao cho Claude và các client AI khác quyền điều khiển terminal, tìm kiếm hệ thống file và sửa file bằng diff. Nó chạy lệnh, sửa file, và có thể chạy code Python, Node hoặc R trong bộ nhớ, tất cả từ một giao diện chat.

Dùng Desktop Commander có tốn tiền không?

Công cụ miễn phí và mã nguồn mở dưới MIT. Theo README, nó chạy trên gói thuê bao của client chủ (như Claude Desktop) chứ không phải một API key trả phí, nên bạn không bị tính token cho các hành động của nó.

Những client AI nào dùng được với Desktop Commander?

Bất kỳ client tương thích MCP nào. README liệt kê cách thiết lập cho Claude Desktop, Claude Code, Cursor, Windsurf, VS Code/Copilot, Cline, Gemini CLI và Codex, cùng chế độ Remote MCP cho ChatGPT và Claude web.

Cấp cho AI quyền truy cập terminal có an toàn không?

Có rủi ro thật. Desktop Commander bổ sung chặn duyệt symlink, danh sách chặn lệnh có chống vượt rào, ghi log kiểm toán và tùy chọn sandbox Docker, nhưng bạn vẫn đang tin model với các lệnh trên máy mình, nên phạm vi và việc rà soát rất quan trọng.

Cài Desktop Commander thế nào?

Cách nhanh nhất là `npx @wonderwhy-er/desktop-commander@latest setup` cho Claude Desktop, rồi khởi động lại Claude. Các tùy chọn khác gồm trình cài bash, Smithery, Docker, và `claude mcp add` cho Claude Code.

Repo liên quan

Nguồn & ghi công

Dựa trên kho GitHub chính thức wonderwhy-er/DesktopCommanderMCP, bao gồm README và metadata của dự án.

Về TopGit