Máy Chủ MCP Filesystem

Máy Chủ MCP “Filesystem” dùng để làm gì?

Filesystem MCP Server cung cấp quyền truy cập an toàn, có thể lập trình vào hệ thống tệp cục bộ thông qua Model Context Protocol (MCP). Nó cho phép các trợ lý AI và client khác tương tác với tệp và thư mục trên máy chủ, thực hiện các thao tác như đọc, ghi, sao chép, di chuyển, tìm kiếm, chỉnh sửa tệp cũng như quản lý thư mục. Được thiết kế để nâng cao quy trình phát triển, máy chủ này mở ra các API cho thao tác tệp nhưng đồng thời áp dụng kiểm soát an toàn nghiêm ngặt—như giới hạn thư mục và xác thực đường dẫn—để ngăn truy cập trái phép. Điều này giúp kết nối các agent AI với các tác vụ quản lý tệp, hỗ trợ các trường hợp như khám phá mã nguồn, chỉnh sửa file tự động, tìm & thay thế hàng loạt, v.v… với quyền kiểm soát chi tiết và an toàn mạnh mẽ.

Danh sách Prompt

Không có prompt template rõ ràng nào được đề cập trong tài liệu hoặc file của repository.

Danh sách Resource

Không có MCP “resource” cụ thể nào được tài liệu hóa trong repository. Máy chủ tập trung vào cung cấp các thao tác hệ thống tệp như công cụ.

Danh sách Công cụ

• read_file
  Đọc toàn bộ nội dung một tệp từ hệ thống tệp.
• read_multiple_files
  Đọc nội dung của nhiều tệp trong một lần thao tác.
• write_file
  Tạo tệp mới hoặc ghi đè nội dung mới lên tệp đã có.
• copy_file
  Sao chép tệp và thư mục.
• move_file
  Di chuyển hoặc đổi tên tệp và thư mục.
• delete_file
  Xóa tệp hoặc thư mục khỏi hệ thống tệp, có thể xóa đệ quy.
• modify_file
  Tìm kiếm và thay thế văn bản trong tệp bằng so khớp chuỗi hoặc regex.
• list_directory
  Liệt kê tất cả tệp và thư mục trong một đường dẫn chỉ định.
• create_directory
  Tạo thư mục mới hoặc đảm bảo thư mục đã tồn tại.
• tree
  Trả về cấu trúc thư mục dạng JSON theo phân cấp.
• search_files
  Tìm kiếm đệ quy tệp và thư mục theo mẫu.
• search_within_files
  Tìm kiếm văn bản bên trong nội dung tệp trên toàn thư mục con.
• get_file_info
  Lấy metadata chi tiết về một tệp hoặc thư mục.
• list_allowed_directories
  Trả về danh sách thư mục mà máy chủ được phép truy cập.

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

• Khám Phá Mã Nguồn Tự Động
  Lập trình viên và AI assistant có thể nhanh chóng khám phá cấu trúc project, liệt kê file, tìm kiếm mẫu mã hoặc loại tệp.
• Chỉnh Sửa File Hàng Loạt
  Dùng công cụ modify_file để thực hiện tìm & thay thế—bằng văn bản thường hoặc regex—trên nhiều file cùng lúc, tối ưu việc sửa mã hoặc tài liệu.
• Quản Lý File An Toàn
  Cung cấp môi trường kiểm soát cho thao tác đọc, ghi, di chuyển, sao chép, hoặc xóa file trong thư mục đã chỉ định—lý tưởng cho tự động hóa mà không làm nguy hại hệ thống toàn cục.
• Tìm Kiếm & Khám Phá Nội Dung
  Nhanh chóng xác định tệp hoặc thư mục khớp mẫu, chứa nội dung cụ thể, hỗ trợ tài liệu hóa, refactor hoặc nghiên cứu.
• Tự Động Sao Lưu hoặc Tổ Chức
  Dùng copy_file, move_file và tree để tự động hóa sao lưu, tổ chức lại cấu trúc project hoặc nhân bản thư mục.

Cách thiết lập

Windsurf

1. Đảm bảo bạn đã cài đặt Go và có file nhị phân MCP Filesystem Server.

2. Mở file cấu hình Windsurf của bạn.

3. Thêm MCP server với đoạn JSON sau:

   {
     "mcpServers": {
       "filesystem": {
         "command": "mcp-filesystem-server",
         "args": ["/path/to/allowed/directory"]
       }
     }
   }
   

4. Lưu cấu hình và khởi động lại Windsurf.

5. Kiểm tra xem MCP server “filesystem” đã xuất hiện trong phần tích hợp MCP chưa.

Bảo mật API key (ví dụ với biến môi trường)

{
  "mcpServers": {
    "filesystem": {
      "command": "mcp-filesystem-server",
      "args": ["/path/to/allowed/directory"],
      "env": {
        "API_KEY": "${FILESYSTEM_API_KEY}"
      },
      "inputs": {
        "api_key": "${FILESYSTEM_API_KEY}"
      }
    }
  }
}

Claude

1. Tải về và cài đặt Filesystem MCP Server.

2. Tìm file cấu hình Claude cho tích hợp MCP.

3. Thêm đăng ký server như sau:

   {
     "mcpServers": {
       "filesystem": {
         "command": "mcp-filesystem-server",
         "args": ["/path/to/allowed/directory"]
       }
     }
   }
   

4. Lưu và khởi động lại Claude.

5. Kiểm tra Filesystem MCP Server đã hoạt động chưa.

Cursor

1. Cài đặt file nhị phân server bằng Go hoặc từ bản phát hành.

2. Mở phần cài đặt hoặc file cấu hình MCP của Cursor.

3. Thêm Filesystem MCP Server:

   {
     "mcpServers": {
       "filesystem": {
         "command": "mcp-filesystem-server",
         "args": ["/path/to/allowed/directory"]
       }
     }
   }
   

4. Lưu và khởi động lại Cursor.

5. Xác nhận tích hợp bằng cách kiểm tra công cụ (ví dụ: list_directory).

Cline

1. Build hoặc tải về file nhị phân Filesystem MCP Server.

2. Cấu hình phần tích hợp MCP của Cline.

3. Thêm vào:

   {
     "mcpServers": {
       "filesystem": {
         "command": "mcp-filesystem-server",
         "args": ["/path/to/allowed/directory"]
       }
     }
   }
   

4. Lưu cấu hình và khởi động lại Cline.

5. Thử chạy thao tác read_file.

Lưu ý về Bảo mật API Key

Sử dụng biến môi trường cho dữ liệu nhạy cảm. Ví dụ:

{
  "mcpServers": {
    "filesystem": {
      "command": "mcp-filesystem-server",
      "args": ["/path/to/allowed/directory"],
      "env": {
        "API_KEY": "${FILESYSTEM_API_KEY}"
      },
      "inputs": {
        "api_key": "${FILESYSTEM_API_KEY}"
      }
    }
  }
}

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

Sử dụng MCP trong FlowHunt

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

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

{
  "filesystem": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

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

Tổng quan

| Hỗ trợ Roots | ✅ | list_allowed_directories hiển thị root được phép |

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

Filesystem MCP Server mạnh mẽ và tập trung vào truy cập hệ thống tệp chi tiết, an toàn—cung cấp bộ thao tác tệp, thư mục toàn diện dưới dạng công cụ MCP. Tài liệu rõ ràng, cung cấp nhiều primitive thực tế cho quy trình phát triển AI. Tuy nhiên, chưa có prompt template hay resource MCP rõ ràng, và các tính năng như sampling chưa đề cập. Hỗ trợ roots thông qua công cụ list_allowed_directories.

Điểm: 8/10 — Công cụ và tài liệu xuất sắc, thiếu sót nhỏ ở prompt/resource và một số tính năng MCP nâng cao.

Điểm MCP