modelcontextprotocol / modelcontextprotocol/python-sdk

Improve docs on how to use `instructions` on `InitializeResult`

Offen Anfängerfreundlich
#1,464 4 Kommentare 1 Reaktion 0 zugewiesene Personen Auf GitHub ansehen

Dieses Issue hat noch niemand übernommen.

documentation P1 ready for work
Vorherrschende Sprache
Python
Sterne
24.3k
Forks
4k
Ø Merge
1 T. 1 Std.
Gemergte PRs (30 T.)
31

Beschreibung

Question

Lots of people want tool bundling / grouping / namespaces to guide servers how to use tools together.

We should make instructions more obvious and have examples for how to use it - maybe this can address a lot of requests for bundling and namespaces if it's more obvious this is something you can do.

https://modelcontextprotocol.io/specification/2025-06-18/schema#initializeresult-instructions

Additional Context

No response

Beitragsleitfaden

Beitragsleitfaden öffnen

Erste Schritte

  1. Lies das ganze Issue und danach den Beitragsleitfaden des Projekts.
  2. Schreib ins Issue, dass du es übernimmst — das erspart doppelte Arbeit.
  3. Forke das Repository und arbeite in einem Branch.
  4. Öffne einen Pull Request, der die Issue-Nummer nennt.

Rechercherichtung

Beginnen Sie mit dem im Issue verlinkten Abschnitt zu den InitializeResult-Anweisungen und prüfen Sie die bestehende Dokumentationsstruktur des SDK, um den besten Ort zu bestimmen. Fügen Sie klare Anleitungen und Beispiele hinzu, die zeigen, wie Anweisungen das Bündeln, Gruppieren oder die Verwendung von Namespaces für Tools beschreiben können. Erledigt ist die Aufgabe, wenn Nutzer anhand der Dokumentation verstehen können, wie sie das Feld verwenden, ohne dessen Zweck erschließen zu müssen.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Bewertung

Tech-Stack
python
Bereich
documentation
Issue-Typ
Dokumentation
Schwierigkeit
2/5
Geschätzter Aufwand
1-3 Stunden
Aktivitätsstatus
Ruhig
Klarheit
Größtenteils klar
Anfängerfreundlichkeit
68/100

Neue Issues direkt in Ihr Postfach

Eine kurze Übersicht über anfängerfreundliche GitHub-Issues.