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

git: README should state plainly that without --repository every reachable repository is in scope

Đang mở Phù hợp với người mới
  • Có gì không ổn?
#5,225 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ó
1/5
Thời gian dự kiến
1-3 giờ
Mức phù hợp với người mới
84/100
Loại issue
Tài liệu
Độ rõ ràng
Đặc tả 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

Đọc src/git/README.md, đặc biệt là phần Configuration và ghi chú hiện có ở dòng 137 về các repository bao chứa. Thêm một phát biểu ngắn, nổi bật, đề cập đến quyền truy cập khi không có --repository, vai trò là giới hạn duy nhất, Client Roots và thời điểm cần đặt giá trị này, đồng thời liên kết đến ghi chú hiện có. Hoàn tất khi các điểm đó được nêu rõ trong README và không có thay đổi hành vi.

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

Mô tả

documentation server-git v2

The git server's README does not say plainly what running without --repository means for access.

Problem

Without --repository, mcp-server-git acts on whatever repo_path each tool call names, so every Git repository the server process can reach is open to every tool, including the writing ones (git_add, git_commit, git_reset, git_checkout, git_create_branch). That is the intended behavior, and --repository is the confinement the server offers and enforces.

The README only says this in passing, in the protocol-eras paragraph (src/git/README.md:107: "repository access comes from --repository alone, or, with no --repository, from each tool call's repo_path"). The configuration examples all pass --repository without saying why, and the Configuration section does not mention what leaving it out does. A reader setting the server up has no clear statement that the flag is the only boundary, and that the server never consults the client's Roots.

Related public discussion: #4550.

Expected

A short, prominent statement in the README, near the Configuration section, that:

  • without --repository, the server reads and writes any Git repository the process can reach, per call;
  • --repository is the only confinement, and the server never asks the client for Roots;
  • --repository should be set whenever the server is used with prompts or content that are not fully trusted;
  • --repository admits the whole enclosing repository, not only the subdirectory given (already described at line 137; link to it).

Documentation only; no behavior change.

Ngôn ngữ chính
TypeScript
Star
91.4k
Fork
11.8k
Merge trung bình
7 giờ 26 phút
Pull request đã merge (30 ngày)
130

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.