Hacktoberfest 2026 : les issues que les mainteneurs ont marquées pour octobre, ouvertes et accessibles aux débutants. Parcourir les issues Hacktoberfest

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

Ouverte Adaptée aux débutants
  • Quelque chose ne va pas ?
#5,225 0 commentaires 0 réactions 0 personnes assignées Voir sur GitHub

Les mainteneurs répondent en général sous 1 jour

Personne n'a encore pris cette issue.

Évaluation

Difficulté
1/5
Temps estimé
1-3 heures
Accessibilité débutants
84/100
Type d'issue
Documentation
Clarté
Clairement spécifiée
Activité
Active
Stack technique
typescript
Domaine
documentation

Piste de recherche

Lisez src/git/README.md, en particulier la section Configuration et la note existante à la ligne 137 au sujet des dépôts englobants. Ajoutez une déclaration courte et bien visible qui couvre l’accès sans --repository, son rôle de seul confinement, Client Roots et le moment où le définir, avec un lien vers la note existante. Le travail est terminé lorsque ces points sont clairs dans le README et qu’aucun comportement ne change.

Rédigé par le modèle d'indexation à partir du texte de l'issue.

Description

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.

Langage dominant
TypeScript
Étoiles
91.4k
Forks
11.8k
Merge moyen
7 h 26 min
PR mergées (30 j)
130

Préparer son environnement

Par où commencer

  1. Lisez l'issue en entier, puis le guide de contribution du projet.
  2. Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
  3. Forkez le dépôt et travaillez sur une branche.
  4. Ouvrez une pull request qui référence le numéro de l'issue.

Autres issues de modelcontextprotocol/servers

Toutes les issues de modelcontextprotocol/servers

Issues similaires

Plus d'issues TypeScript

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.