Hacktoberfest 2026: những issue maintainer đã đánh dấu cho tháng Mười, đang mở và phù hợp người mới. Xem issue Hacktoberfest

Filesystem README recommends deprecated MCP Roots protocol for restricting directory access

Đang mở Phù hợp với người mới
#4,844 0 bình luận 0 reaction 0 người được giao Xem trên GitHub

Maintainer thường phản hồi trong vòng 1 ngày

Chưa có ai nhận issue này.

Đánh giá

Độ khó
2/5
Thời gian dự kiến
1-3 giờ
Mức phù hợp với người mới
76/100
Loại issue
Tài liệu
Độ rõ ràng
Khá rõ ràng
Mức độ hoạt động
Sôi nổi
Công nghệ
typescript
Lĩnh vực
documentation

Hướng nghiên cứu

Bắt đầu với phần trong README.md về việc hạn chế quyền truy cập hệ thống tệp thông qua Roots và đối chiếu hướng dẫn trong đó với đặc tả MCP được tham chiếu về các tính năng đã deprecated. Kiểm tra xem phần triển khai server có sử dụng ListRootsRequest hay không, như issue đề cập, và ghi nhận mọi follow-up cần thiết. Được xem là hoàn thành khi README.md tài liệu hóa các phương án thay thế hiện tại, đánh dấu hướng dẫn về Roots được giữ lại là legacy nếu phù hợp, và mô tả rõ cấu hình truy cập được hỗ trợ.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

Summary

The README.md contains a section recommending the use of the MCP Roots protocol as the mechanism for restricting which directories the filesystem server can access. However, according to the current official MCP specification, Roots is deprecated as of protocol version 2026-07-28 and scheduled for removal.

Source: MCP Specification — Deprecated features

Why this matters

  • New users following the README will adopt a deprecated mechanism that is scheduled for removal from the protocol.
  • Roots-based access restriction may not work with newer MCP clients, so the documented guidance will break over time.
  • The project's documented access-control story should stay aligned with the current specification.

Suggested changes

  • Update the README section to stop recommending Roots as the primary way to restrict directory access
  • Document the alternatives recommended by the spec:
    • passing directories/files via tool parameters
    • resource URIs
    • server configuration (e.g., allowed directories passed via CLI arguments, which the server already supports)
  • If any Roots-related guidance or behavior is kept, mark it explicitly as legacy/deprecated with a pointer to the migration guidance
  • Check whether the server implementation itself relies on Roots (e.g., ListRootsRequest) and, if so, open a follow-up issue for migrating away from it

References

Ngôn ngữ chính
TypeScript
Star
90.5k
Fork
11.7k
Merge trung bình
5 ngày 19 giờ
Pull request đã merge (30 ngày)
6

Chuẩn bị môi trường

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của modelcontextprotocol/servers

Tất cả issue của modelcontextprotocol/servers

Issue tương tự

Thêm issue về TypeScript

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.