Quickstart: SSH clone URL, a duplicate `cd`, and a version mismatch in the `init` sample break the copy-paste path
Personne n'a encore pris cette issue.
Évaluation
- Difficulté
- 2/5
- Temps estimé
- 1-3 heures
- Accessibilité débutants
- 78/100
- Type d'issue
- Documentation
- Clarté
- Plutôt claire
- Activité
- Active
- Stack technique
- git, markdown
- Domaine
- documentation
Piste de recherche
Modifiez docs/modelcontextprotocol-io/quickstart.mdx. Examinez la commande de clonage, le cd répété de l’étape 2, la sortie d’exemple de init à l’étape 4 et l’onglet Homebrew CodeGroup non étiqueté ; vérifiez le comportement attendu de mcp-publisher init avant de modifier l’exemple de version. C’est terminé lorsque le parcours numéroté à copier-coller fonctionne avec les prérequis documentés et que les onglets et la sortie d’exemple sont cohérents.
Rédigé par le modèle d'indexation à partir du texte de l'issue.
Description
Three small things in docs/modelcontextprotocol-io/quickstart.mdx break the copy-paste path for a first-time publisher. Each has a one-line fix.
1. The clone command uses SSH, in a tutorial that never establishes SSH
git clone --depth 1 git@github.com:modelcontextprotocol/quickstart-resources.git
quickstart-resources is public, and the only authentication this tutorial sets up is the browser device flow in Step 5. A reader who has a GitHub account but no SSH key registered — which the prerequisites explicitly allow, they ask for "a GitHub account" and nothing more — hits Permission denied (publickey) on the very first command, before they have learned anything about the registry.
-git clone --depth 1 git@github.com:modelcontextprotocol/quickstart-resources.git
+git clone --depth 1 https://github.com/modelcontextprotocol/quickstart-resources.git
2. Step 2 re-enters a directory the reader is already in
The prerequisites block ends with cd weather-server-typescript. Step 2 then opens with:
# Navigate to project directory
cd weather-server-typescript
Pasted in sequence, that is cd: weather-server-typescript: No such file or directory, and the reader is left wondering whether they lost the directory. The line is only correct for someone who brought their own server and skipped the prerequisites block — the opposite of who the numbered path is written for. Dropping it (or moving it into the bring-your-own note) resolves it.
3. The mcp-publisher init sample output contradicts the state the tutorial just created
The prerequisites have the reader edit package.json to "version": "1.0.1", and Step 2 publishes that version to npm. Step 4 then shows init generating:
"version": "1.0.0",
...
"version": "1.0.0",
followed by a diff bumping both back to 1.0.1.
Since the surrounding prose says init generates the template "with some information derived from your project", a reader reasonably expects 1.0.1 in that output and is then unsure whether they mis-edited something, or whether init ignores the version deliberately. Either the sample output predates the 1.0.1 edit, or init genuinely does not read version from package.json — in which case one sentence saying so would turn a confusing diff into an obvious one.
Minor: the Homebrew tab in Step 3 is unlabeled
The CodeGroup labels its first two tabs macOS/Linux and Windows, but the third (```bash, brew install mcp-publisher) has no title, so it renders as bash beside them. A macOS reader sees two tabs that both apply and no signal which is preferred.
Checked while writing this, all correct, so no action needed on them:
- every release asset name matches the
mcp-publisher_$(uname -s)_$(uname -m)URL pattern in Step 3, on the currentv1.8.1release, including both Windows architectures; weather-server-typescriptis still present inquickstart-resources;/v0.1/servers?search=in Step 6 resolves and returns the expected{"servers":[...]}shape.
Happy to open a PR with 1, 2 and 4 if that is easier than patching them yourselves — 3 needs someone who knows what init is supposed to do with version.
- Langage dominant
- Go
- Étoiles
- 7.3k
- Forks
- 994
- Merge moyen
- 4 j 12 h
- PR mergées (30 j)
- 19
Guide de contribution
Ouvrir le guide de contribution
Par où commencer
- Lisez l'issue en entier, puis le guide de contribution du projet.
- Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
- Forkez le dépôt et travaillez sur une branche.
- Ouvrez une pull request qui référence le numéro de l'issue.
Autres issues de modelcontextprotocol/registry
-
Difficulté 1/5 Moins d'une heure Accessibilité débutants 68/100
modelcontextprotocol/registry#1652 ·
-
Difficulté 2/5 1-3 heures Accessibilité débutants 74/100
modelcontextprotocol/registry#1465 · 1 commentaire ·
-
Difficulté 1/5 Moins d'une heure Accessibilité débutants 84/100
modelcontextprotocol/registry#1359 ·
-
Difficulté 4/5 3-5 jours Accessibilité débutants 25/100
modelcontextprotocol/registry#1651 ·
-
Difficulté 4/5 3-5 jours Accessibilité débutants 52/100
modelcontextprotocol/registry#1649 · 1 réaction ·
Toutes les issues de modelcontextprotocol/registry
Issues similaires
-
Difficulté 1/5 Moins d'une heure Accessibilité débutants 84/100
-
enhancement needs triage
Difficulté 2/5 1-3 heures Accessibilité débutants 68/100
-
kind/cleanup
Difficulté 2/5 1-3 heures Accessibilité débutants 88/100
kubernetes-sigs/kueue#15947 ·
-
Difficulté 2/5 1-3 heures Accessibilité débutants 78/100
sympozium-ai/sympozium#627 ·
-
Difficulté 2/5 1-3 heures Accessibilité débutants 86/100