Hacktoberfest 2026: le issue che i maintainer hanno segnato per ottobre, aperte e adatte ai principianti. Sfoglia le issue Hacktoberfest

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

Aperta Adatta ai principianti
  • Qualcosa non va?
#5,225 1 commento 0 reazioni 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 1 giorno

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
1/5
Tempo stimato
1-3 ore
Idoneità per principianti
84/100
Tipo di issue
Documentazione
Chiarezza
Specificata chiaramente
Stato di attività
Attiva
Stack tecnologico
typescript
Ambito
documentation

Direzione di ricerca

Leggi src/git/README.md, in particolare la sezione Configuration e la nota esistente alla riga 137 sui repository contenitori. Aggiungi una breve dichiarazione ben visibile che tratti l’accesso senza --repository, il suo ruolo come unico confinamento, Client Roots e quando impostarlo, con un collegamento alla nota esistente. Il lavoro è completato quando questi punti sono chiari nel README e il comportamento non cambia.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

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.

Lingua principale
TypeScript
Stelle
91.4k
Fork
11.8k
Merge medio
7h 26m
PR unite (30g)
130

Preparare l'ambiente

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di modelcontextprotocol/servers

Tutte le issue di modelcontextprotocol/servers

Issue simili

Altre issue su TypeScript

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.