mcpignore-filesystem MCP Server

“mcpignore-filesystem” MCP Server làm gì?

mcpignore-filesystem MCP Server là một công cụ dựa trên Node.js giúp nâng cao quy trình phát triển trợ lý AI bằng cách cung cấp kiểm soát truy cập hệ thống tệp an toàn, chi tiết. Dựa trên MCP Server Filesystem tiêu chuẩn, máy chủ này bổ sung hỗ trợ tệp .mcpignore, cho phép bạn giới hạn những tệp và thư mục mà client MCP (như AI agent) có thể tương tác. Bằng cách chỉ định các mẫu ignore tương tự như .gitignore, bạn có thể bảo vệ dữ liệu nhạy cảm và đảm bảo chỉ các tệp được ủy quyền mới có thể thực hiện các thao tác như đọc, ghi, quản lý thư mục và tìm kiếm. Máy chủ này hỗ trợ các tác vụ phát triển liên quan tới quản lý tệp đồng thời duy trì bảo mật dữ liệu nghiêm ngặt và kiểm soát truy cập, lý tưởng cho các nhóm cần giao diện hệ thống tệp mạnh mẽ, tùy chỉnh cho quy trình AI.

Danh sách Prompt

Không có prompt template nào được đề cập trong kho lưu trữ.

Danh sách Resource

Không có MCP resource rõ ràng nào được ghi nhận trong kho lưu trữ.

Danh sách Tool

• read_file: Đọc tệp trừ khi trùng mẫu .mcpignore (Bị chặn nếu trùng).
• read_multiple_files: Đọc nhiều tệp trừ khi bị ignore (Bị chặn nếu trùng).
• write_file: Ghi vào tệp trừ khi bị ignore (Bị chặn nếu trùng).
• edit_file: Chỉnh sửa tệp trừ khi bị ignore (Bị chặn nếu trùng).
• create_directory: Tạo thư mục trừ khi bị ignore (Bị chặn nếu trùng).
• list_directory: Liệt kê nội dung thư mục trừ khi bị ignore (Bị chặn nếu trùng).
• move_file: Di chuyển tệp hoặc thư mục trừ khi bị ignore (Bị chặn nếu trùng).
• get_file_info: Lấy metadata tệp trừ khi bị ignore (Bị chặn nếu trùng).
• directory_tree: Lấy cấu trúc thư mục (Được phép, chỉ hiển thị tên).
• search_files: Tìm kiếm tệp (Được phép, chỉ hiển thị tên).
• list_allowed_directories: Liệt kê các thư mục được phép truy cập (Không áp dụng cho logic ignore).

Trường hợp sử dụng MCP Server này

• Bảo mật hệ thống tệp chi tiết: Lập trình viên có thể cung cấp cho AI agent quyền truy cập kiểm soát vào thư mục dự án, bảo vệ các tệp nhạy cảm (ví dụ: .env, secrets, credentials) bằng cách chỉ định trong .mcpignore.
• Khám phá codebase an toàn: Công cụ AI có thể phân tích, điều hướng codebase lớn nhưng đảm bảo các tệp bí mật hoặc sở hữu trí tuệ không bị lộ.
• Quản lý tệp tự động hóa: Tự động hóa các tác vụ như sắp xếp, tìm kiếm hoặc di chuyển tệp giữa các thư mục với giới hạn truy cập mạnh mẽ qua .mcpignore.
• Môi trường phát triển hợp tác: Chia sẻ thư mục an toàn cho trợ lý AI chỉnh sửa hoặc tìm kiếm, đồng thời chặn truy cập tệp nội bộ hoặc tạm thời.
• Tuân thủ và kiểm toán: Thực thi tuân thủ dữ liệu bằng cách đảm bảo các loại dữ liệu/tệp cụ thể không thể truy cập bởi công cụ tự động, hỗ trợ kiểm toán và quản trị.

Hướng dẫn thiết lập

Windsurf

Không có hướng dẫn cụ thể về Windsurf trong kho lưu trữ.

Claude

1. Đảm bảo đã cài đặt Node.js và npx.
2. Mở claude_desktop_config.json của bạn.
3. Thêm cấu hình MCP server như bên dưới.
4. Lưu file và khởi động lại Claude.
5. Xác minh server đang chạy và có thể truy cập.

{
  "mcpServers": {
    "mcpignore-filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@cyberhaven/mcpignore-filesystem",
        "/Users/<username>/Desktop",
        "/path/to/other/allowed/dir"
      ]
    }
  }
}

Bảo mật API Key (ví dụ):

{
  "mcpServers": {
    "mcpignore-filesystem": {
      "command": "npx",
      "args": [ ... ],
      "env": {
        "API_KEY": "${MCP_SERVER_API_KEY}"
      },
      "inputs": {
        "api_key": "${MCP_SERVER_API_KEY}"
      }
    }
  }
}

Cursor

1. Đảm bảo đã cài đặt Node.js và npx.
2. Mở file cấu hình mcp.json.
3. Thêm cấu hình server như bên dưới.
4. Lưu file và khởi động lại Cursor.
5. Xác nhận kết nối server.

{
  "mcpServers": {
    "mcpignore-filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@cyberhaven/mcpignore-filesystem",
        "/Users/<username>/Desktop",
        "/path/to/other/allowed/dir"
      ]
    }
  }
}

Bảo mật API Key: (xem ví dụ Claude ở trên)

Cline

1. Đảm bảo đã cài đặt Node.js và npx.
2. Mở cline_mcp_settings.json của bạn.
3. Thêm cấu hình server.
4. Lưu và khởi động lại Cline.
5. Kiểm tra khả năng truy cập server.

{
  "mcpServers": {
    "mcpignore-filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@cyberhaven/mcpignore-filesystem",
        "/Users/<username>/Desktop",
        "/path/to/other/allowed/dir"
      ]
    }
  }
}

Bảo mật API Key: (xem ví dụ Claude ở trên)

Windsurf

Không có hướng dẫn thiết lập.

Sử dụng MCP này trong flow

Sử dụng MCP trong FlowHunt

Để tích hợp MCP server vào quy trình FlowHunt của bạn, hãy bắt đầu bằng cách thêm thành phần MCP vào flow rồi 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 hệ thống MCP, hãy thêm chi tiết MCP server của bạn theo định dạng JSON dưới đây:

{
  "mcpignore-filesystem": {
    "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 tool với đầy đủ chức năng. Lưu ý thay “mcpignore-filesystem” bằng tên thực tế MCP server của bạn và thay đổi URL thành URL MCP server của riêng bạn.

Tổng quan

Dựa trên thông tin hiện có, MCP server này cung cấp bộ công cụ hệ thống tệp mạnh mẽ, tài liệu rõ ràng cùng tính năng bảo mật cao, nhưng thiếu prompt template và resource. Không thấy đề cập rõ về Roots hoặc hỗ trợ Sampling. Do đó, đây là lựa chọn mạnh cho quản lý tệp an toàn, nhưng có thể kém phù hợp với quy trình yêu cầu prompt template hoặc quản lý resource nâng cao.

Điểm MCP

Đánh giá:
Tôi chấm MCP server này 6/10. Nó tập trung rõ về bảo mật, có tài liệu và license, nhưng thiếu prompt template, resource và chưa thấy có roots hoặc hỗ trợ sampling. Giá trị mạnh nhất dành cho các nhóm muốn truy cập hệ thống tệp an toàn dựa trên ignore cho AI agent.